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Radio Frequency Interference Statement 



The equipment described in this manual generates and uses radio-frequency 
energy. If it is not installed and used properly, that is, in strict accordance with 
our instructions, it may cause interference with radio and television reception. 
This equipment has been tested and complies with the limits for a Class B 
computing device in accordance with the specifications in Subpart J, Part 15, 
of FCC rules. These rules are designed to provide reasonable protection 
against such interference in a residential installation. However, there is no 
guarantee that the interference will not occur in a particular installation 
especially if you use a "rabbit ear" television antenna. (A "rabbit ear" antenna 
is the tefescoping-rod type usually contained on TV receivers.) 
You can determine whether your computer is causing interference by turning It 
off. If the interference stops, it was probably caused by the computer or its 
peripheral devices. To further isolate the problem: 

• Disconnect the peripheral devices and their input/output cables one at a 
time if the interference stops, it is caused by either the peripheral device 
or its I/O cable. These devices usually require shielded I/O cables. For 
Apple peripheral devices, you can obtain the proper shielded cable from 
your dealer. For non-Apple peripheral devices, contact the manufacturer 
or dealer for assistance. 

If your computer does cause interference to radio or television reception you 
can try to correct the interference by using one or more of the following ' 

measures; 

• Turn the TV or radio antenna until the interference stops. 

• Move the computer to one side or the other of the TV or radio. 

• Move the computer farther away from the TV or radio, 

• Plug the computer into an outlet that is on a different circuit than the TV or 
radio. (That is, make certain the computer and the radio or television set 
are on circuits controlled by different circuit breakers or fuses.) 

• Consider installing a rooftop television antenna with coaxial cable lead-in 
between the antenna and TV. 

If necessary, you should consult your dealer or an experienced radio/television 
technician for additional suggestions. You may find helpful the following 
booklet, prepared by the Federal Communications Commission: 
"How to Identify and Resolve Radio-TV interference Problems. " 
This booklet is available from the U.S. Government Printing Office, 
Washington, DC 20402, stock number 004-000-00345-4. 
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This is the reference manual for the Apple lie personal 
computer. It contains detailed descriptions of all of the 
hardware and firmware that make up the Apple lie. The manual 
is divided into two volumes: Volume I contains all the chapters; 
Volume II contains the appendixes. 

This manual contains a lot of information about the way the 
Apple Uc works, but it doesn't tell you how to use the Apple He. 
For this, you should read the other Apple lie manuals, especially 
the Apple He Interactive Owner's Manual. 

This manual describes the internal operation of the Apple lie as 
completely as possible in a single reference work. The criterion 
for deciding to include an item of information was whether it 
would help an assembly-language programmer or hardware 
designer. 




Contents of This Manual 



This manual presents first the physical characteristics of the 
Apple lie (Chapter 1), then the hardware locations and firmware 
that control memory management and input/output (Chapters 2 
through 10), and finally the electrical and electronic 
inplementation of those capabilities (Chapter 11). The 
appendixes contain summary tables and information comparing 
other Apple products to the Apple lie. 

Chapter 1 identifies the main physical features of the Apple lie. 

Chapter 2 presents an overview of the 65C02 microprocessor 
(whose instruction set appears in Appendix A), and then 
discusses the processor's address space, what it contains, and 
how to control it. 
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i 

Chapter 3 is an introduction to Chapters 4 through 9. It 

describes the common characteristics of input/output j- 

processing. Chapters 4 through 9 then discuss the kinds of — 

devices — both built-in and attachable — that the Apple lie 

supports: mm 

H 

• Keyboard and speaker (Chapter 4) 



• Video display (Chapter 5) 

• Disk drives {Chapter 6) 

• Serial port 1 for printers and plotters (Chapter 7) 

• Serial port 2 for modems and other communication devices 






(Chapter 8) 



• 



t 



Mouse and hand controls, including game paddles and 

joysticks (Chapter 9) 
Chapter 10 is a brief tutorial on how to use the Monitor 
firmware to disassemble and debug machine-language 
programs, and manipulate memory contents. 

Chapter 1 1 is a detailed description of the hardware that Et 

implements the features described in the earlier chapters. This 
information is included primarily for programmers, but it will 
also hefp you if you just want to understand more about the H, 

way the Apple lie works. 

Additional reference information appears in the appendixes. 
Appendix A is the manufacturers description of the 65C02 
instruction set, including the 27 new instructions available on 
the CMOS version of the 65C02 used in the Apple lie. — 

ml 

Appendix B is a memory map of the Apple lie, including detailed 

tables of page zero, page three, the screen holes, and the 

hardware page, m 

Appendix C lists the published firmware entry points, arranged 

by address, and indicates where in the manual they are — - 

described. The list includes I/O firmware (pages $C1 through Ef 

$CF) and Monitor firmware (pages $F0 through $FF). For 

Applesoft interpreter firmware (pages $00 through $EF), refer to i— « 

the Applesoft BASfC Reference Manual {in two volumes). 9r 

Appendix D discusses the operating systems and languages 

that run on the Apple lie. J~ 

Appendix E describes how to use the Apple lie's interrupt 

handling capabilities, mmt 
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Appendix F contains an overview of the differences among the 
Apple II series computers. 

Appendix G contains the keyboard layouts, code conversion 
tables, and external power supply characteristics of USA and 
international models of the Apple He. 

Appendix H contains reference tables for code and number 
base conversion. 

Appendix I contains a listing code for the Monitor, enhanced 
video firmware, and input/output firmware contained in the 
Apple Ifc. The listings do not include the buitt-in Applesoft 
interpreter, which is discussed in the Applesoft BASIC 
Programmer 's Reference Manual. 

The bibliography lists articles and books containing additional 
information about the Apple lie and related products. 

The glossary defines many of the technical terms used in this 
manual. 

At the back of this manual is a Teli Apple Card, Please fill it out 
and send it in. Your experience with this manual will help us 
plan new reference materials. 



Symbols in This Manual 



This manual uses a three-level numbering system to make it 
easier to cross-reference information. A reference like 2.4.3 
means Chapter 2, section 4, subsection 3. G.1.8 refers to 
Appendix G, section 1, subsection 8. 

Special text in this manual is set off in several different ways, 
as shown in these examples. 



Warning 

Important information regarding your safety or protect/on of 

data appears in boxes like this. 



Note: Information that is useful but not central to the 
discussion in a given part of the text appears in gray boxes 

like this. 



Captions, cross-references and 
incidental definitions appear in 
marginal glosses like this. 
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This chapter introduces you to the Apple lie. It identifies the 
major components of the machine, both outside and inside, and 
tells you where in the rest of the manual to find information 
about each one. 



m 1.1 Outside of Machine 

Appendix G illustrates and Figure 1-1 shows an Apple lie with a Standard USA keyboard. 

discusses several international y n j s chapter discusses both the Standard (Sholes) and 

keyboard layouts. Simplified (Dvorak) USA keyboards, as well as the lights and 

switches on the front of the machine. 

Figure 1-2 is a diagram of the parts of the computer that you 
can see, hear, or access from the outside. The Apple He comes 
equipped with keyboard, speaker (with headphone jack and 
volume control), disk drive, attachable power supply, and 
internal voltage converter. It also has built-in interfaces and 
connectors for a serial printer, video display, special video 
display adapters, modem, mouse, and game controls. 




1.1 Outside of Machine 1 1 



There are no user connections inside the Apple lie. but 
expansion is possible and easy with the connectors on the 
Apple lie back panel. 



Figure 1-1. Apple lie With 
Standard USA Keyboard 



Figure 1-2. Block Diagram of 
External Features 




1 
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Keyboard Disk Drive Back Panel Speaker 

{See Figs. 1-4 and 1-5) (See Fig. 1-7) (&ee Fig. 1-8) (See Fig. 1-6) 



ASCII stands for American 
Standard Code for Information 
Interchange. Table 4-2 lists the 
ASCII character encoding for the 
Standard and Simplified USA 
keyboards. Appendix G lists the 
encoding for international 
keyboards. 



1. 1. 1 The Keyboard 

The front of the Apple He includes the keyboard (Figure 1-3), 
the computer's primary input device. It has a typewriter layout, 
uppercase and lowercase, and can generate all 128 
characters— including control characters— in the ASCII 
character set. The front of the computer also has a reset key, 
80/40 switch, keyboard switch, disk-use light, and power light. 
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Figure 1-3. Keyboard and Front of Apple He 




Reset Switch 



Power Light 



80/40 Column Switch Keyboard 



Disk Use Light 



Table 1-1 lists the characteristics of all Apple lie keyboards and 
front panels. 

Table 1-1. Keyboard Specifications 



Number of keys; 


63 


Character encoding: 


ASCII 


Number of codes: 


128 


Features: 


Automatic repeat, two-key rollover 


Special function keys: 


(BESET),®, QD 


Cursor movement keys: 


I- J. t+l (O, ID. [RETURN), [DELETE 1 

CT«D 


Modifier keys: 


:;.0 •■iTROI }, ' SHIFT |, [CAPS-LOCK], 1 ESC] 


Front-panel switches: 


80/40 switch, keyboard switch 


Front-panel lights: 


Power light, disk-use light 



Features 

The Apple lie keyboard has automatic repeat on all character 
keys: if you hold the key down longer than about a second, the 
character it generates repeats. It also has two-key rollover, 
which means if you type a second key before releasing a prior 
key. the new character enters the computer the same as 
though the previous key were released first. (This is important 
for fast touch typists.) 



1.1 Outside of Machine 
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The Apple keys are connected to 
one-bit addresses in memory, 
described in Chapter 9. 



Chapter 2 describes the results of 
the various reset procedures. 



The Monitor is a built-in program 
that performs some of the basic 
activities of the computer, such as 
retrieving and storing key codes as 
they come in, and clearing or 
updating the display screen. 

The o ther keys to use with 
{control} are: @ [ \ J * _ and their 
international equivalent (see 
Appendix G). 






Special Function Keys 

The Apple He has three special function keys: (reset) , and two 
keys marked with apples: one outlined, [til, and one filled in, 
CD- 



(reset) has a d irect line to the 65C02 microprocessor: holding 
down (control) while pressing ( reset ) causes the Apple lie to 
restart processing with a program that puts the machine in a 
known state (Chapter 2). So you don't accidentally destroy 
current w ork, the reset takes effect only if you hold down 
(control"] while pressing [reset] . 

If you hold down both (control) and Q5] while pressing (reset] 
the computer starts up as if you just turned it on. 



Cursor Movement Keys 

Four of the cursor movement keys have arrows on them: left, 
right, down and up. The other three keys are (return) , ("delete' 
and (tab). All generate ASCII control characters (Table 4-2). 
However, it is up to the operating system or application 
program to interpret and act on the control codes that these 
keys generate. 



Modifier Keys 

Three special keys, (control) , (shift) and (caps-lock) , change 
the codes generated by the other keys. None of these keys 
generates a code when pressed by itself. A fourth key, (esg), 
generates a control code that the Monitor responds to by 
interpreting certain subsequent keystrokes in a modified way. 

(control) , when pressed in combination with letter keys or 
certain other keys, produces ASCII control characters. 

(shift) works the same on the Apple He as on an ordinary 
typewriter: it selects uppercase letters and the upper characters 
on the keys. 

(caps-lock ) . in its down position, changes the letter keys to 
uppercase, but does not affect other keys. 

t ESC ) is not a modifier key in the same sense as (control) and 
(shift) ; you do not hold it down while pressing other keys. 
Rather, you press Cesc") and it generates the ESC control 
character (key code $lB^see Table 4-2). Many programs, 
including the built-in Monitor program, then interpret other 
specific keys as designating an escape sequence. 
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This switch takes effect only if the 
program or operating system you 
are using actually checks it. See 

Table 4-1. 



The 80/40 Switch 

The 80/40 switch selects whether information is to be displayed 
in 40 columns to the line or 80 columns. This switch indicates 
40-column display in its down position, and 80-column display 
in its up position. 

Note: Not all programs check this switch. Even programs that 
do check the switch may rely on the user setting it before 
running the program. 



The Keyboard Switch 

The keyboard switch selects which of the two keyboard layouts 
and character sets the computer is to get from the keyboard 
and display on the screen. On USA versions of the Apple lie. 
select the Standard Sholes keyboard layout (Figure 1-4) with 
the switch in the up position, and the Dvorak Simplified layout 
(Figure 1-5) with the switch in the down position. 



Figure 1-4. The USA Standard or Sholes Keyboard (Keyboard Switch Up) 
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1.1 Outside of Machine 



Figure 1-5. Simplified or Dvorak Keyboard (Keyboard Switch Down). Note: Shaded characters may be in different 
positions on some models. 
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Appendix G illustrates the On international models, the keycaps indicate the character 

Aboard S'po^oTs on P ositions for the ,ocal ke V board ^^ *«■ is selected when 

several international versions of the tne keyboard switch is down. When up, the keyboard switch 

A PP |e ,lc selects the USA Standard characters and key layout. 



Disk -Use and Power Lights 

The red disk-use light glows whenever the built-in disk drives 
motor is on. 

The green power light glows when normal power is present at 
the Apple lies internal power supply. 



Warning 

if the power fight flashes on and off, turn off the computer 
immediately. Find out what caused the condition (such as a 
brownout) and remedy it before turning the computer on again. 
Above all, do not use the disk drive when the power light is 
flashing; this may damage the computer. 
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The way programs control the 

speaker is described in section 4,2, 



1 . 1.2 The Speaker 

The Apple lie has a loudspeaker in the bottom of the case, as 
shown in Figure 1-6. The speaker enables Apple lie programs 
to produce a variety of sounds that make programs more 
useful and interesting. There is also a volume control on the 
left side of the Apple lie case, and a mini-phone jack for 
connecting headphones or an external speaker. 

The jack accepts either one-channel (monaural) or two-channel 
(stereo) plugs, although speaker output is monaural only. 
Inserting a plug disconnects the built-in speaker. 

Figure 1-6. Speaker, Volume Control, and Phone Jack 




Phone Jack 

Volume Control Knob 



(Inside) 



1.1 Outside of Machine 
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I/O means input (information 
coming into the computer) and 
output (information going out of the 
computer). Chapter 6 describes 
how to use the Apple lie's disk I/O 
hardware and firmware. 



1. 1.3 The Built-in Disk Drive 

The Apple lie has a built-in disk drive (Figure 1-7) that is fully 
compatible with Apple Disk II— that is, it reads and writes 
single-sided, 35-track disks. The drive door is on the right side 
of the Apple lie case. 

Figure 1-7, Built-in Disk Drive 
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Disk Drive Door 



1. 1.4 The Back Panel 

The back panel of the Apple He (Figure 1-8) has seven 
connectors and a main power switch. From left to right they 
are: 

• a 9-pin D-type miniature connector for connecting hand 
controls, a mouse, a joystick or some other pointing device 

• a 5-pin DIN connector for serial input and output (port 2; 
normally for a modem) 

• a 15-pin D-type connector for video expansion 

• an RCA-type jack for a video monitor 

• a 19-pin D-type connector for connecting a second disk 
drive 

• another 5-pin DIN connector for serial input and output 
(port 1 ; normally for a printer or plotter) 

• a special 7-pin DIN connector for power input 



c 
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The installation manuals for the external devices contain 
instructions for connecting them. Be sure to move the handle 
until it clicks into position for propping up the computer before 
attaching cables to the back panel. 



Figure 1-8. Back Panel Connectors 




Mouse and Hand Serial Port 2 Video Expansion Handle 
Control Connector Connector Connector 

(See Figs. 11-37 (See Fig. 11-30) (See Fig 1 1 -25) 
and 11-42) 

Video Output 

Connector 

(See Fig, 11-24) 



Serial Port 1 

Connector 

(See Fig. 11-30) 



Power Switch 



External 

Disk Drive 

Connector 

(See Fig, 11-26) 



External Power 
Connector 

(See Fig, 11-1) 
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1.2 Inside of Machine 



Chapter 1 1 discusses in further 
detaif these components and how 
they work. 



Figure 1-9 shows the main components inside the 
Apple He computer. 

Figure 1-9. Block Diagram of inside of Machine 
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Voltage Speaker Built-in Main Logic Board 

Converter (underneath) Disk Drive (See Figure 1-11) 



1.2. 1 The Internal Voltage Converter 

The built-in voltage converter operates from a 15V DC source, 
such as provided by the external power supply furnished with 
the Apple He (Figure 1-10). The voltage converter provides 
power for the logic board, built-in disk drive, one external disk 
drive, and the I/O signals available at the back panel. 
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Figure 1~iQ. Power Supply and Voltage Converter 




Power Switch Power Supply 

Internal Voltage Converter 



Complete specifications of the 
Apple lie power supply and voltage 
converter appear in Chapter 11. 



The voltage converter produces three different voltages; +5V, 
+ 12V, and -12V, (Minus 5V is derived from -12V on the main 
logic board.) It is a high-efficiency switching converter that 
protects itself and the rest of the Apple lie against short 
circuits and other mishaps. 



1.2.2 The Main Logic Board 

Almost all the electronic parts of the Apple lie are attached to 
the main logic board, which is mounted flat in the bottom of the 
case. 



1 ,2 Inside of Machine 
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Firmware is program code that is 
stored in read-only memory. It can 
be read and executed, but not 
changed. 



Figure 1-11 shows the main logic board and the most important 
integrated circuits (ICs) in the Apple He. They are the 
CPU (central processing unit), RAM (random access memory), 
ROM (read-only memory) ICs for keyboard encoding, display 
character generation, and firmware, and the five custom 
integrated circuits. 

Figure f-ff. Main Logic Board 
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The specifications of the 65C02 are 
given in Chapter 1 1 ; the 65C02 

instruction se( is given in 
Appendix A. 



The CPU is a 65C02 microprocessor. The 65C02 is a CMOS 
version of the 6502, which is an eight-bit microprocessor with a 
sixteen-bit address bus. In the Apple lie, the 65C02 runs at 
1 MHz and performs up to 500,000 eight-bit operations per 
second. 
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Chapter 1 ; Introduction 



Chapter 11 describes how RAM 

works; Appendix B lists important 
RAM locations . 



a__ ROMs: see Chapter 1 1 , 



The Applesoft language interpreter 
■"■"> is described in the Applesoft 

Tutorial and the Applesoft BASIC 
Programmer's Reference Manual. 



Memory addressing. - see 
Chapter 2. 

See Chapters 3 through 9, 
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Chapter 11 discusses the functions 
of these integrated circuits in some 
detail. 



The keyboard is scanned by an \C that generates matrix values 
for a read-only memory (ROM), The value of this ASCII code is 
latched and readable by programs. 

The character generator ROM converts display information to a 
form that display devices can use. 

The other ROM contains the Monitor, the Applesoft BASIC 
interpreter, enhanced video firmware, and other input/output 
firmware. The firmware that this ROM contains is described 
throughout this manual. 

Five of the large IC's are custom-made for the Apple lie: 

• The Memory Management Unit (MMU) contains most of the 
logic that controls memory addressing in the Apple lie. 

• The input/Output Unit (IOU) contains most of the logic that 
controls the built-in input and output features of the 
Apple He. 

• The Timing Generator (TMG) generates all the system and 
I/O clock and timing signals from a 14 MHz oscillator. 

• The General Logic Unit (GLU) performs the remaining logic 
functions required. 

• The Integrated Woz Machine (IWM) is a single-chip version 
of the Apple Disk II controller card. 

1.2. 3 The Other Circuit Boards 

The Apple lie contains other circuit boards that serve special 
purposes: a motor-speed control board and a read/write logic 
board for the disk drive, and a matrix board for detecting the 
position of keys pressed. This manual does not discuss these 
circuit boards. 

Warning 

Adjustment of disk drive speed must be done by an authorized 
Apple Service Center. Do not attempt to adjust the speed of 
your built-in disk drive. If you do, you may damage it and you 
will void your warranty. 
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This chapter is an introduction to the microprocessor, the 
number of separate locations (addresses) it can access, and the 
addresses set aside for special purposes. The last section of 
this chapter describes the reset routines, which restore the 

computer to a known state. 



2. 1 The 65C02 Microprocessor 



Figure 2-1 is a model of the 65C02 microprocessor. The 65C02 
has one 16 bit register and five 8-bit registers. Registers are 
fast-acting storage areas where the processor performs and 
keeps track of its work. 



2.1 The 65C02 Microprocessor | -J5 



Figure 2-1. Block Diagram Model of 65C02. Copyright 1982, NCR Corporation. 
Used by permission of NCR Corporation, Dayton, Ohio- 
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Each of the other registers holds 
eight bits (one byte), so the 65C02 
is called an 8-bit processor. 



The 16-bit register is called the program counter (PC). It 
specifies the address in memory that contains the instruction 
the processor is currently carrying out, A sixteen-bit register 
can specify any one of 65,536 memory addresses, and so the 
65C02 is said to have an address space of 65,536 locations. 
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Appendix A lists the instructions 
the 65C02 can carry out, their use, 
and their effects on the registers. 
For further information, consult the 
pertinent books listed tn the 
Bibliography. 



The five 8-bit registers in the 65C02 are 

• The accumulator, or A register. The accumulator is like a 
desktop where the processor performs mathematical and 
logical operations on information. 

• The index registers, X and Y. The processor uses these 
registers to modify the address where information is to be 
found or placed, and to pass information from one program 
to another. 

• A stack pointer, or S register. The processor uses a 
256-byte region of memory — page 1 — as an area to stack up 
bytes for future use. The stack is empty when the computer 
is turned on. Several 65C02 instructions either push (store) 
the contents of a register onto the stack, or pull (retrieve) a 
byte from the stack and place it in a register. The S register 
keeps track of the byte in the stack that is currently ready 
for use. 

• A processor status register, called the P register. Seven of 
the eight bits of this register store flags that record the 
outcome of processor activities, and that can be checked by 
later instructions to determine what the processor should do 

next. 



2.2 Overview of the Address Space 



Soft switches are described in 
sections 2.4 and 2,5. 



The Apple lie's 65C02 microprocessor can address 65,536 
(64K) memory locations. All of the Apple lie's RAM, ROM, and 
input and output (I/O) devices are accessed using addresses in 
this 64K address range. Some functions have the same 
addresses — but not at the same time. The Apple lie controls its 
shared addresses using soft switches. 

Note: When referring to memory space, K stands for 1024, 
which is 2 to the tenth power It is called K because 1024 is 
very close to the value 1 000, which has long been 
abbreviated K for Kilo. Some early computers even saved the 
extra 24 locations for spares. 

RAM stands for random-access (readable and writable) 
memory. ROM means read-only memory. Refer to the 
Glossary for further information. 



2.2 Overview of the Address Space 



There are two other ROMs in the 
Apple lie: one to generate 
characters corresponding to 
keystrokes (section 11,7), and 
another to generate characters tor 
display (section 11.9). However, 
these ROMs are not addressable 
by the microprocessor. 



All input and output in the Apple lie is memory mapped — that is, 
specific memory addresses (all in the SCO page) are allocated to 
each I/O device. In this chapter, the I/O memory spaces are 
described simply as areas of memory. For details of the built-in 
I/O features and firmware, refer to the descriptions in 
Chapters 3 through 9. 

A block of 256 address locations is called a page. A one-byte 
address counter or 8-bit register can specify one of 
256 different locations. Thus, page consists of memory 
locations from to 255 (hexadecimal $0 to $FF), inclusive; 
page 1 consists of locations 256 to 51 1 (hexadecimal 
$100 to $1FF); and so on. In this manual, all page numbers 
(except some of the low-numbered ones) are given in 
hexadecimal format. 
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Note: The first two digits of a four-digit hexadecimal address 
are the page number. There are 256 pages of 256 bytes each 
in the address space. This kind of page is different from the 
display areas in the Apple lie, which are sometimes referred 
to as Page 1 and Page 2. 
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2.3 Memory Map and Memory Switching 



Figure 2-2 is a map of the Apple lie's memory address space 
and what the major blocks of addresses are used for. As you 
can see in the figure, addresses $C000 through $C0FF contain 
hardware only, and addresses $C100 through $CFFF contain 
ROM only. At all other addresses there are two, three or even 
five blocks of RAM or ROM locations. At any given time, only 
one block of RAM or ROM occupies each set of addresses. As 
described later in this chapter, switches in the hardware page 
control which blocks the processor is to use. 
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Figure 2-2. Apple He Memory Map 
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2.3 Memory Map and Memory Switching 
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2.3. r Main RAM Addresses ($OOOQ~$BFFF and 
$DOOO-$FFFF) 

The area labeled Main RAM in Figure 2-2 is so-called because 
some or all of it is present in all models of the Apple II series of 
computers. The Apple lie has 64K bytes of main RAM, 



2.3.3 ROM Addresses ($C100-$FFFF) 

ROM addresses contain the built-in Apple lie firmware. 
Addresses $C100 through SCFFF belong exclusively to ROM, 
Addresses $D000 through SFFFF are shared by ROM, main 
RAM, and auxiliary RAM; the selection techniques are described 
in section 2.4,2, 

Pages $C1 through CF (addresses 5C100 through SCFFF) 
contain I/O firmware. The following associations apply for the 
Apple lie: 

• Serial port 1 (RS-232 device) firmware entry points are on 
page $C1 . 

• Serial port 2 (communication device) firmware entry points 
are on page SC2. 

• Video output firmware entry points are on page $C3; the 
enhanced video firmware and miscellaneous I/O support 
routines occupy pages SC8 through $CF, 

• Mouse firmware entry points are on page $C4. 

• Disk I/O firmware entry points are on page $C6, 
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2.3.2 Auxiliary RAM Addresses ($O00O-$BFFF and 
$DOQ0-$FFFF) 

The Apple lie has another 64K of auxiliary RAM built in. Some 

or all of auxiliary memory is present in an Apple lie with one of 

the 80-column cards installed (Appendix F), but there is no 

auxiliary RAM in the Apple II or II Plus. This portion of RAM u- 

cannot be used simultaneously with main RAM; you must use 

the soft switches described in this chapter to select main or 

auxiliary memory for a given range of addresses. 
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The operation of the Applesoft 
Interpreter firmware is described in 
the Applesoft BASIC Programmer's 
Reference Manual. 



Note: This correspondence of ports and entry points does 
not imply that all of each ports firmware occupies a specific 
page. The Apple lie I/O port firmware space is allocated in a 
way that provides the best possible performance. 

Pages $D0 through $F7 {addresses SDOOO through $F7FF) 
contain the Applesoft Interpreter firmware. 

Pages $F8 through $FF (addresses $F800 through $FFFF) 
contain the Monitor, which is described in Chapter 10. Monitor 
routines that make various input and output procedures easier 
are described in Chapters 3 through 9. 
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Chapters 3 through 9 describe the 
Apple He's input and output 
locations. Appendix B lists all of 
these locations in address order, 
rather than by function. 



Bit numbering [fl a byte is 
explained in Appendix H. 



Z3.4 Hardware Addresses ($C000-$C0FF) 

The Apple He's built-in input and output functions, and the 
switching of blocks of address space, all take place via locations 
on the SCO page — that is. in the address range SC000 through 
$C0FF. This chapter describes the address space (memory) 
switches. 

The hardware functions on this page fall into five basic 
categories: 

• Data inputs. The only data input is location $C000, where 
the low-order seven bits (bits 6 through 0) represent the 
keyboard key just pressed. (This data is guaranteed valid 
only when bit 7 = 1) 

• Flag inputs. Most built-in input locations are single-bit flags 
in the high-order (bit 7) position of their respective memory 
addresses. Flags have only two values: on (greater than or 
equal to 128 or $80) or off (less than 128 or $80). 

The switch, hand controller (analog) and button inputs, and 
the keyboard strobe, are examples of flag inputs. The 
locations for reading soft-switch states are also of this type. 

• Strobe outputs. The clear keyboard strobe (Chapter 4) and 
paddle timer strobe (Chapter 9) outputs are controlled by 
memory locations. If your program reads the contents of one 
of these locations, then the function associated with that 
location will be activated. 
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• Toggle switches. The Apple lie has only one toggle switch: 
the speaker switch. A toggle switch has only one address 
assigned to it; each time you access it, it changes to its 
other state (on or off). 

Reading the speaker toggle at location $C030 clicks the 
speaker once. However, if you write to the speaker location, 
the microprocessor activates the address bus twice during 
successive clock cycles, causing the speaker toggle to end 
up in its original state before the speaker cone can move. 
Therefore, you should read, rather than write, to use this 
device. 

The processor cannot read the on/off status of the speaker 
switch. 

• Soft switches. Soft switches are two-position switches 
turned on by accessing one address and turned off by 
accessing another address. Most of these switches have a 
third address associated with them for reading the state of 
the switch. 

There are eight soft switches that select different 
combinations of bank-switched memory (section 2.4). Four of 
these eight switches require that your program read them 
twice in succession to activate them. 
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2.4 Bank-Switched Memory 



The stack and zero page ar& 
switched this way so that system 
software running in the 
bank-switched memory space can 
maintain its own stack and zero 
page while it manipulates the 48K 
memory space (section 2.5). 



Section 2.4.1 discusses what 
functions various addresses are 
set aside for; section 2.4.2 
describes how to select the 
memory banks you want. 



The memory areas described in this section are called 
bank-switched memory (Figure 2-3) because so many banks 
(ranges) of addresses— one bank of ROM and up to four banks 
of RAM — occupy the same group of locations among the upper 
addresses of memory. Pages $00 and $01 , at the low end of 
memory, are included here because the two sets of them— one 
in main RAM and one in auxiliary RAM— are controlled by the 
same switches as the high-address banks. 
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Figure ^-J. Bank-Switched Memory 
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See Table B-1 in Appendix B. 



All these memory banks are 
controlled by the soft switches 
described in section 2.4.2. 



2.4.1 Page Allocations 

Pages zero and one are used by many of the 65C02 
instructions. The ROM and RAM addresses in bank-switched 
memory are usually occupied by system software such as 
interpreters, compilers, and operating systems. 

Page $00 (One -Byte Addresses) 

Several of the 65C02 microprocessors addressing modes — for 
example, indirect addressing — require the use of addresses in 
page zero, or zero page. However, the Monitor, the interpreters, 
and the operating systems all make extensive use of page zero, 
too. One way to avoid conflicts is to use only those page-zero 
locations not already used by these other programs. But there 
is another way. 

As you can see from Table B-1 , page zero is pretty well used 
up, except for a few bytes here and there. Rather than trying to 
squeeze your data into an unused corner, you may prefer a 
safer alternative: turn off interrupts, save the contents of part of 
page zero, use that part, then restore the previous contents to 
page zero, restore interrupts to their previous state, and then 
pass control to another program. 

Page $01 (The B5C02 Stack) 

The 65C02 microprocessor uses page 1 as its stack — a place 
where it can store subroutine return addresses, in last-in, 
first-out sequence. Programs can also use the stack for 
temporary storage of registers {via push and pull instructions). 
However, programs should use the stack carefully. 

Pages $D0 Through $FF (ROM and RAM) 

The memory address space from SD000 through SFFFF is used 
for both ROM and RAM. The 12K bytes of ROM in this address 
space contain the Monitor and the Applesoft BASIC interpreter. 

There are 16K bytes of main RAM in this 12K space, with two 
banks occupying the 4K of addresses from SD000 through 
$DFFF. The RAM is normally used for storing other languages 
such as Pascal, or operating systems such as ProDOS. 

There are also 16K bytes of auxiliary RAM in this 12K space, 
again with double occupancy in the address range $D000 
through $DFFF. 
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2 A. 2 Using Bank Selector Switches 

You switch banks of memory in the same way you switch other 
functions in the Apple lie: by using soft switches. These soft 
switches do four things: 

1. Select either RAM or ROM in this memory space. 

2. Allow or inhibit (write-protect) writing to the RAM when RAM 
is selected, 

3. Select the first or second 4K-byte bank of RAM in the 
address space SD000 to SDFFF. 

4. Select either main RAM or auxiliary RAM, 

A Warning 

Do not use soft switches without careful planning. Careless 
switching between HAM and ROM is almost certain to have 
catastrophic effects on your program. 

Table 2-1 shows the addresses of the soft switches for 
selecting all allowed combinations of reading and writing in this 
memory space, and the addresses of the locations to read the 
switch settings. Figures 2-4 through 2-10 illustrate how to select 
the combinations and what the resulting status of each switch 
is. 

To make sure you do not inadvertently remove write protection 
from bank-switched RAM. the four write-enable addresses 
require that you read them twice in succession (indicated by RR 
in Table 2-1), 

Because the ALTZP switch shares the read keyboard address, 
you must write (W in Table 2-1) to its locations to change the 
switch setting. 

To find out which way a switch is set, read the appropriate 
location and then check bit 7 (shown as R7 in Table 2-1), If the 
bit is a 1 , the answer to the question given in the table is 
affirmative. 

Note: There is no way to check whether write protection is 
on or off. 
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Table 2-1. Bank Select Switches 



Action 


Hex 


R 


SC080 


RR 


SC081 


R 


SC082 


RR 


SC083 


R 


$C088 


RR 


$C089 


R 


SC08A 


RR 


SC08B 


R7 


SC011 



Name 



Function 

Read RAM; no write; use SD00O 
bank 2. 

Read ROM; write RAM; use 
$D0O0 bank 2. 

Read ROM; no write; use $DO00 
bank 2. 

Read and write RAM; use SDOOO 
bank 2. 

Read RAM; no write; use $DOO0 
bank 1. 

Read ROM; write RAM; use 
SDOOO bank 1 . 

Read ROM; no write; use SDOOO 
bank 1. 

Read and write RAM; use $D000 
bank 1. 



Z 








R7 


SC011 RDBNK2 


Read whether $0000 bank 2 (1) or 
bank 1 {0). 






R7 


$C012 RDLCRAM 


Reading RAM 


(1)Ol 


ROM (OK 


— 

fc- 

— - 






SC008 ALTZP 
$C009 ALTZP 


Off: use main bank, page and 
page 1. 

On: use auxiliary bank, page 
and page 1 - 




R7 


SC016 RDALTZP 


Read whether 
main (0) bank. 


auxil 


ary (1) or 
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Figure 2-4. Read ROM 
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W SC009 Turn on ALTZP 

R SC082 Read ROM, use bank 2* 
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Read resulting status: 

R7 SC0 16 Read ALTZP; bit 7 - 

R7 SC01 1 "Read BANK2; bll 7 - 1 or 

R7 JC012 R«ad ENLCRAM; bit 7 - 



Read resulting status: 

R7 SCO 16 Read ALTZP; bit 7 - 1 

R7 SC0 1 1 * Read BANK2; bit 7 - 1 or 

R7 $G012 Read ENLCRAM; bit 7 - 



Legend: 



= Read memory J = Inactive memory R7 = Read, check bit 7 RR - Read twice in succession 

- Write memory R = Read W - Write 
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Figure 2-5. Read ROM, Write RAM, and Use First $D0 Bank 
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Read resulting status: 

R7 SC0 16 ReadALTZP;blt7 - 
R7 SC0 11 ReadBANK2;bit7 - 
R7 SCQ12 ReadENLCRAM, bit 7 - 



Select memory: 
W SC009 
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Read resulting, status: 

R7 SC0 16 Read ALTZP; bit 7 - 1 
R7 SC01 1 Read BANK2; bit 7 - 
R7 SC0 12 Read ENLCRAM; Olt 7 = 
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Li 'g end: 



- Read memory J - Inactive memory R7 - Read, Check bit 7 RR = Read twice In succession 

- Write memory R - Read w - Write 
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Figure 2-6. Read ROM. Write RAM, and Use Second $D0 Bank 
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Read resulting status 

R7 SC0 16 Read ALTZP; Wt 7 - 
R7 SCO 1 1 Read BANKS; bit 7 = 1 
R7 SC012 Read EMLCRAM; bit 7 - 
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Read resulting status: 

R7 $C016 Read ALTZP; bit 7 = 1 
R7 SC01 1 Read BANK?; bit 7 = 1 
R7 SC012 ReadENLCRAM;bit7-0 



RHdmemar) J - Inactive memory 

Write memory R 



R7 - Read, check bit 7 
W - Write 



RR - Read twice in succession 
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Figure 2-7. Read RAM and Use First $D0 Bank 
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Read resulting status: 

R7 $C0t6 Read ALTZP; bit 7 - 
R7 $001 1 Read BANK2; bit 7 - 
R7 $C012 ReadENLCRAM; bit 7 = 1 



Read resulting status: 

R7 $C0 16 Read ALTZP; bll 7 = 1 
R7 SC0 11 Road8ANK2;bH7 = 
R7 SC012 Read ENLCRAM; bit 7 = 1 
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Legend: 



- Read memory 1 - Inactive memory R7 - Read, check bit 7 RR = Read twice In succession. 

- Write memory R - Read W - Write 
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Figure 2-8. Read RAM and Use Second $D0 Bank 
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R7 SC0 16 Read ALTZP; bit 7 = 1 
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Legend: 



- Read memory 
= Write memory 



j - Inactive memory 
R - Read 



R? - Read, check bit 7 
W - Write 



RR = Read twice in succession 



2.4 Bank-Switched Memory 



Figure 2-9. Read and Write RAM and Use First SDQ Bank 
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Read resulting status: 
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Legend: 



- Read memory J - Inactive memory R7 = Read, check bit 7 RR = Read twice In succession 
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Figure 2-10, Read and Write RAM and Use Second $D0 Bank 
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Section 2.5-1 describes the 
memory pages the hardware and 
firmware use for various purposes. 
Sections 2.5.2 and 2.5.4 explain 
how to select main or auxiliary 
RAM for read/write and video 
storage, respectively. Section 2.5.3 
tells you how to use firmware 
routines to transfer data or 
program control between main and 
auxiliary RAM, 



Note: You cant read one RAM bank and write to the other; if 
you select either RAM bank for reading, you get that one for 
writing as well. However, you can read ROM and write RAM 
(Figures 2-5 and 2-6), which makes it easy to transfer 
firmware to bank-switched RAM if you want to use it with a 
program there. 



2.5 48K Memory 



The 48K memory space (actually, 47-1 /2K) extends from 
location $200 to location $BFFF (Figure 2-11) in both main and 
auxiliary RAM, The amount of storage available in this address 
space depends on what language or operating system you are 
using, and what video display needs your program has. 
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Figure 2-11. 48K Memory Map 
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The term system refers to the 
computer and its firmware plus 
whatever operating system you are 
using. 



A buffer is any storage area set 
aside for one program or device to 
put information into and another to 
take information out of at a 
different time or rate. 



Refer to Appendix D and to the 
appropriate programmer and 
reference manuals for operating 
system use of page 3. 

Global storage refers to an area 
reserved for information that 
programs use in common. 
Vectors — the addresses of special 
routines — are examples of this 
kind of information. Section 2.6 
discusses the global storage and 
vectors found on page $03. 



See Chapter 5. 



See section 3.4,5. 



2.5. 1 Page Allocations 

Most of the Apple lies 48K RAM is available for storing your 
programs and data. However, a few RAM pages are reserved 
for the use of the Monitor firmware, the Applesoft BASIC 
interpreter, and whatever video display you may select 

Note: The system does not prevent your using these pages, 
but if you do use them, you must be careful not to disturb 
the system data they contain. 



Page $02 (The Input Buffer) 

The GETLN input routine (section 3.2.3) uses page 2 as its 
keyboard-input buffer. The size of this buffer (256 bytes) sets 
the maximum size of input strings read by Applesoft or the 
Monitor. If you know that you wont be typing any long input 
strings (more than, say, 30 characters), you can store 
temporary data at the upper end of page 2. 



Page $03 (Global Storage and Vectors) 

The Monitor and operating systems use parts of page 3 for 
global storage and vectors. Table 2-7 shows the part of page 
the built-in firmware uses. 



Pages $04 Through $07 (Text and Low-Resolution Page 1) 

The most often used display buffer is the Text and 
Low-Resolution Graphics Page 1 (TLP1 in Figure 2-11), which 
occupies main memory pages S04 through $07. It is not usable 
for program and data storage if you are using Monitor routines 
or Applesoft, or with almost any other program that uses text 
or low resolution display. 

Text and Low-Resolution Page 1X (TLP1X) is an identical 
display page occupying auxiliary memory pages $04 
through $07, This pair of Text and Low-Resolution graphics 
pages are used together to produce 80-column text display. 

There are 128 locations in pages $04-$07 (64 in main RAM, 
64 in auxiliary RAM) that are not displayed on the screen. 
These locations are called screen holes. 
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Warning 

The screen holes are reserved for use by the built-in firmware. 



Pages $08 Through $0B (Text and Low-Resolution Page 2) 

The second Text and Low-Resolution Graphics display 
buffer, TLP2, occupies main memory pages $08 through $0B, 
Most programs do not use Page 2 for displays, but TLP2 is 
there for display use if required. 

Text and Low-Resolution Page 2X (TLP2X) is an identical 
display buffer occupying pages $08 through $0B in auxiliary 
memory. 

Note: Apple lie firmware does not provide a way to use the 
second pair of Text and Low-Resolution graphics pages for 
80-column text display. 



Serial port 2: see Chapter 8. 



See Chapter 5. 



Page $08 (Communication Port Buffers) 

Serial port 2 uses the first half of auxiliary memory page $08 
(addresses S0800 through S087F) as a keyboard input buffer, 
and the second half of the page (addresses $0880 through 
S08FF) as a serial input buffer. These buffers increase the data 
transfer rates possible with the serial communication port. 
Appendix E explains how to use these features. 

If your program does not use this page for buffers, it can use it 
as part of TPLX. 

Pages $20 Through $3F (High-Resolution Page 1) 

The primary high-resolution-graphics display buffer, called 
High-Resolution Page 1 (HRP1). occupies the 32 memory pages 
from $20 through $3F (locations $2000 through $3FFF). If your 
program doesn't use high-resolution graphics, this area is 
usable for programs or data. 

High-Resolution Page 1X (HRP1X) is an identical display page 
occupying auxiliary memory pages $20 through $3F. 

The Apple lie can display double-high-resolution graphics by 
interleaving HRP1 and HRP1X. 
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For more information about the 
display buffers, see Chapter 5. 



For details, refer to section 2.5.4, 



lei 



Pages $40 Through $5F (High-Resolution Page 2) 

High-Resolution-Graphics Page 2 occupies main memory 
pages $40 through $5F (locations $4000 through $5FFF). Most 
programs use this area for program or data storage. However, 
it is also available as a second high-resolution page. 

High-Resolution-Graphics Page 2X (HRP2X) occupies auxiliary 
memory pages $40 through $5F. 

Note* Apple lie firmware provides high-resolution graphics 
routines for HRP1 and HRP2 only. Refer to the Applesoft 
BASIC Programmer's Reference Manual. 



2.5.2 Using 48K Memory Switches 

Two switches select main or auxiliary RAM in the 48K memory 
space (Table 2-2): RAMRD determines which to use for 
reading, and RAMWRT determines which to use for writing. 
When these switches are on, they select auxiliary memory. 
When they are off, they select main memory. 



Warning 

This discussion assumes that the 80STORE switch, used to 

control display memory, is off. 



Each switch has three locations assigned to it: one to turn it on. 
one to turn it off, and a third to read its state. Because the 
memory locations for turning the switches on and off are 
shared with keyboard reading functions, you must write to these 
addresses to use them for memory switching. 

For each switch, you can read bit 7 at its third location to check 
whether the switch is on or off. If the switch is on, bit 7 is 1; if 
the switch is off, bit 7 is 0. 

Figures 2-12 and 2-13 illustrate how the switches work. 
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Table 2-2. 48K Memory Switches. Note: 80STORE must be off to switch alt 
memory in this range, including display memory (Table 2-6). 

Function 

Off: read main 48K RAM. 

On: read auxiliary 48K RAM, 

Read whether main (0) or auxiliary 
(D 

Off: write to main 48K RAM. 

On: write to auxiliary 48K RAM. 



Action 


Hex 


Name 


w 


$C002 


RAMRD 


w 


SC003 


RAMRD 


R7 


SC013 


RDRAMRD 


W 


$C004 


RAMWRT 


W 


$C005 


RAMWRT 


R7 


SC014 


RDRAMWR 



RDRAMWRT Read whether main (0) or auxiliary 



Figure 2-12. 48K RAM Selection: Split Pairs 
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80STORE; bit 7 = 
RAMRD; bit 7 = 
RAMWRT; bit 7 - 1 



TLP2X 



Read resulting status: 

R7 SC018 Read 80STORE; bit 7 = 
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R7 SC0 14 Read RAMWRT; bit 7 = 
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Figure 2-13. 48K RAM Selection: One Side Only 
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2.5.3 Transfers Between Main and Auxiliary Memory 

If you want to write assembly-language programs that use 
auxiliary memory but you don't want to manage the auxiliary 
memory yourself, you can use the built-in 48K RAM transfer 
routines. These routines make it possible to move between 
main and auxiliary memory without having to manipulate the 
soft switches described in Section 2.5.2. 

Note: The routines described below make it easier to use 
auxiliary memory, but they do not protect you from errors. 
You still have to plan your use of auxiliary memory to avoid 
catastrophic effects on your program. 



I 



Table 2-3. 48K RAM Transfer Routines 
Action Hex Name 

JSR SC311 MOVEAUX 



JMP 



SC314 



XFER 



Function 

Moves data blocks between mam 
and auxiliary 48 K memory. 

Transfers program control 
between main and auxiliary 
48K memory. 



A 



Transferring Data 

In your assembly-language programs, you can use the built-in 
routine named MOVEAUX to copy blocks of data from main 
memory to auxiliary memory or from auxiliary memory to main 
memory. Before calling this routine, you must put the data 
addresses into byte pairs in page zero and set or clear the 
carry bit to select the direction of the move. 

Warning 

Don't try to use MOVEAUX to copy data in bank-switched 
memory (page zero, page one or pages $D0 through $FF). 
MOVEAUX uses page zero all during the copy. 



The pairs of bytes you use for passing addresses to this routine 
are called A1, A2, and A4, and they are used for parameter 
passing by several of the Apple lies built-in routines. The 
addresses of these byte pairs are shown in Table 2-4. 
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Table 2-4, Parameters for MOVEAUX Routine 

Name Location Parameter Passed 

Carry 1 = Move from main to auxiliary 

memory B— 

= Move from auxiliary to main 
memory 

AfL $3C Source starting address, low-order ^ 

byte Ifig 

A1H $3D Source starting address, high-order 

byte J 



~ 

». 

^ 



w 



A2L S3E Source ending address, low-order 

byte 

A2H $3F Source ending address, high-order 

byte 

A4L $42 Destination starting address, 

low-order byte jg 

A4H $43 Destination starting address, 

high-order byte 

X,Y,A These registers are preserved U- 

Put the addresses of the first and last bytes of the block of 
memory you want to copy into A1 and A2, Put the starting 
address of the block of memory you want to copy the data to 
into A4. 

The MOVEAUX routine uses the carry bit to select the direction U 
to copy the data. To copy data from main memory to auxiliary 
memory, set the carry bit (SEC instruction); to copy data from — 

auxiliary memory to main memory, clear the carry bit 
(CLC instruction). 

When you make the subroutine call to MOVEAUX, the 
subroutine copies the block of data as specified by the 
A register and the carry bit. When it is finished, the accumulator 
and the X and Y registers are just as they were when you called 

it. 



— 



Transferring Control 

You can use the built-in routine named XFER to transfer control 
to and from program segments in auxiliary memory. You must — 

set up three parameters before using XFER: the address of the 
routine you are transferring to, the direction of the transfer, and 
which page zero and stack you want to use, — > 
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Table 2-5. Parameters for XFER Routine 

Name or 

Location Parameter Passed 

Carry 1 = Transfer from main to 

auxiliary memory 
= Transfer from auxiliary to 

main memory 

Overflow 1 = Use page zero and stack in 

auxiliary memory 
= Use page zero and stack in 
main memory 

S3ED Program starting address, 

low-order byte 

S3EE Program starting address, 

high-order byte 

X.Y.A These registers are preserved. 

Put the transfer address into the two bytes at locations $3ED 
and $3EE, with the low-order byte first, as usual. The direction 
of the transfer is controlled by the carry bit: set the carry bit to 
transfer to a program in auxiliary memory; clear the carry bit to 
transfer to a program in main memory. 

Use the overflow bit to select which page zero and stack you 
want to use: clear the overflow bit to use the main memory; set 
the overflow bit (cause an overflow condition) to use the 
auxiliary memory. 

After you have set up the parameters, pass control to the XFER 
routine by a jump instruction, rather than a subroutine calk 

A Warning 

It is your responsibility as the programmer to save the current 
Refer to Appendix E for stack pointer before using XFER and to restore it after 

instructions on how to do this. regaining control. Failure to do so will cause program errors. 



2.5.4 Using Display Memory Switches 

Section 2.5.2 discusses how to select main or auxiliary RAM 
for the 48K memory space. However, under many 
circumstances your program may want to control reading and 
writing to display pages separately. The switches discussed in 
this section override the effects of RAMRD and RAMWRT for 
display pages only. 



■ 



2.5 48K Memory 



One of the switches, 80STORE, 
shares its on and off addresses 
with a keyboard reading function. 
As a result, your program must 
write to these locations to turn the 
switch on and off. 



Three switches are involved in the display page selection 
process. Each of them has three locations assigned to it: one to 
turn it on, one to turn it off, and a third to read its state 
(Table 2-6). 

For each switch, you can read bit 7 at its third location to check 
whether the switch is on or off. If the switch is on, bit 7 is 1 ; if 
the switch is off, bit 7 is 0. 

Here is how these switches work for reading and writing. 

• If HIRES is off, then PAGE2 switches between Text and 
Low-Resolution Graphics (TLP) pages only. If HIRES is on, 
then PAGE2 switches between TLP pages and 
High-Resolution Graphics (HRP) pages. 

• If 80STORE is off, RAMRD and RAMWRT (Table 2-2) 
determine whether main or auxiliary RAM locations are used. 
PAGE2 selects pages for display (Chapter 5), but not for 
reading and writing. 

• If 80STORE is on, it overrides RAMRD and RAMWRT with 
respect to the display pages selected by HIRES and PAGE2 
(Figures 2-15 and 2-16). 
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Tabte 2-6. 


Display Memory 


Switches 




L, 


See Chapter 5 for a discussion of 
text and high-resolution page and 
the high-resolution pages. 


Action 

w 


Hex 

$cooo 

SC001 


Name 
8QSTORE 

80STORE 


Function 

Off; RAMRD and RAMWRT 
determine RAM locations. 

On: PAGE2 switches between 
TLP1 and TLP1X, and (if HIRES 
on) between HRP1 and HRP1X, 


b 

1 




R7 


$CG18 


RD80STORE 


Read whether 80 STORE on (1) or 
off (0) 


L 




R 


$C054 


PAGE2 


Oft; select TLP1 and HRP1. 






R 


$C055 


PAGE2 


On: if 80STORE off, switch to 
TLP2, and (if HIRES on) to HRP2. 
If 80STORE on, switch to TLP1X, 
and (if HIRES on) to HRP1X, 




R7 


$C01C 


ROPAGE2 


Read whether PAGE2 on (1) or 

off (0) 


i — . 




R 


SC056 


HIRES 


Off: display text and 
low-resolution page. 


1 

r 1 




R 


SC057 


HIRES 


On; display high-resolution pages; 
make PAGE2 switch between 
high-resolution pages. 


b 




R7 


SC01D 


RDHIRES 


Read whether HIRES on (1) or 
off (0) 
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Figure 2-14. PAGE2 Selections With 80STORE On and HIRES Off 
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Figure 2-15. PAGE2 Selections With 80STORE On and HIRES On 
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Read resulting status: 

R7 $C018 Read 80STORE; bit 7 = 1 

R7 $C01D Read HIRES; bit? = 1 
R7 $C01C Read PAGE2; bit 7 = 1 
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2.6 The Reset Routine 



A procedure called the reset routine (Figure 2-16) puts the 
Apple lie into a known state when it has just been turned on or 
you hold down ( control ) while pressing (reset) . The reset 
routine puts the Apple lie into its normal operating mode and 
restarts the program indicated at locations S3F2 
and S3F3 (Table 2-7). 



Figure 2-16. Reset Routine Flowchart 
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When you initiate a reset, hardware in the Apple lie sets the 
memory-controlling soft switches to normal: main ROM and 
RAM are enabled, auxiliary RAM is disabled and the 
bank-switched memory space is set up to read from ROM and 
write to RAM, using the second bank at $D000\ 



JS- 

C 



481 



Chapter 2: Memory Organization and Control 






The reset vector validity check is 
described in section 2.6.4. 



The reset routine sets the display-controlling soft switches to 
display 40-column text Page 1 using the primary character set, 
then sets the display window equal to the full 40-column 
display, puts the cursor at the bottom of the screen, and sets 
the text display format to normal. 

The reset routine also sets the keyboard and display as the 
standard input and output devices (Chapter 3), It masks mouse 
interrupts and sets mouse defaults {Table 9-1). Finally, it 
enables DHIRES switch access (by turning on IQUDIS), clears 
the keyboard strobe, and sounds the speaker. 

The Apple lie has three types of reset: power-on reset, also 
called cold start reset; warm-start reset, and forced cofd-start 
reset. The procedure described above is the same for any type 
of reset. What happens next depends on the reset vector. The 
reset routine checks the reset vector to determine whether it is 
valid or not. If the reset was caused by turning the power on, 
the vector will not be valid, and the reset routine will perform 
the cold-start procedure. If the vector is valid, the routine will 
perform the warm-start procedure. 



2.6. 1 The Cold-Start Procedure (Power On) 

!f the reset vector is not valid, either the Apple lie has just been 
turned on or something has caused memory contents to be 
changed. The reset routine clears the display and puts the 
string Apple //c at the top of the display. It loads the reset 
vector and the validity-check byte as described in section 2.6,1, 
then initiates the startup routine that resides in the disk 
controller firmware. The bootstrap routine then loads whatever 
operating system resides on the disk in the built-in drive. When 
the operating system has been loaded, it displays other 
messages on the screen. If there is no disk in the disk drive, 
the drive motor keeps spinning for a brief time. Then the 
firmware shuts it off and displays the message Check Disk 
Drive at the bottom of the screen. 



If you press ( control H reset ) again before the startup 
procedure is completed, the reset routine continues without 
using the disk, and passes control to the Applesoft BASIC 

interpreter. 



2.6 The Reset Routine 



2.6.2 The Warm-Start Procedure (CONTROL-RESET) 

Whenever you press ( control K reset) when the Apple lie has 
already completed a cold-start reset, the reset vector is still 
valid and it is not necessary to reinitialize the entire system. The 
reset routine simply uses the vector to transfer control to the 
program it points to, which at power-up is the Applesoft 
interpreter. 



Note: A program residing only in bank-switched RAM cannot 
use the reset vector to regain control after a reset, because 
upon reset the hardware selects the ROM for reading in the 
bank-switched memory space. 



i 



If the vector does point to the Applesoft interpreter, your 
Applesoft program and variables are still intact. If you are using 
DOS or ProDOS™, that operating system is the resident 
program and it restarts the BASIC interpreter you were using 

when you pressed ( control H reset) . 






2.6.3 Forced Cold Start ( C3 -CONTROL-RESET) 

If a program has set the reset vector to point to its own 

warm-start address, as described below, pressing 

t control H reset ) causes transfer of control to that program. If 

you want to stop such a program without turning the power off 

and on, you can force a cold-start reset by holding down ~- 

( control ) and @], then pressing and releasing (reset) . 

Note: When you want to stop a program unconditionally — for 

example, to start up the Apple lie with some other 

program — you should use the forced cold-start reset, ^* 

[p~ K coNTRotX reset ) t instead of turning the power off and j^- 

on. 

The forced cold-start reset works as follows. First, it destroys jj- 

the program or data in memory by writing two bytes of arbitrary 

data into each page of main RAM, The two bytes that get _* 

written over in page 3 are the ones that contain the reset JL 

vector. The warm-start reset routine finds the error, and so 

performs a normal cold -start reset. ^ 

£ 
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Note: If you press both (jiT) and fW} during power-up or 
[ controlK reset ] , built-in exercise code is executed. This 
code is for production and has no end-user value. 



2.6.4 The Reset Vector 

The cold-start reset routine stores the starting address of the 
built-in Applesoft interpreter, low-order byte first, in the reset 
vector address at locations $3F2 and $3F3. It then stores a 
validity-check byte, also called the power-up byte, at 
location S3F4. The validity-check byte is computed by 
performing an exclusive-OR of the second byte of the vector 
with the constant 165 (hexadecimal $A5). Each time you reset 
the Apple lie, the reset routine uses this byte to determine 
whether the reset vector is still valid 

You can change the reset vector so that the reset routine will 
transfer control to your program instead of to the Applesoft 
interpreter. For this to work, you must also change the 
validity-check byte to the exclusive-OR of the high-order byte of 
your new reset vector with the constant 165 ($A5). If you fail to 
do this, then the next time you reset the Apple He, the reset 
routine will determine that the reset vector is invalid and 
perform a cold-start reset, eventually transferring control to the 
disk bootstrap routine or to Applesoft. 

There is a subroutine that generates the validity-check byte for 
the current reset vector. This subroutine, called SETPWRC, is at 
location $FB6F. When your program finishes, it can return the 
Apple lie to normal operation by restoring the original reset 
vector and again calling the subroutine to fix up the 
validity-check byte. 



2 6 The Reset Routine fsT" 



Table 2-7. Page 3 Vectors 

Vector Address Vector Function 

$3F0 Address of the subroutine that handles BRK requests 

$3F1 (normally $59, SFA). 

S3F2 Reset vector (see text). fe 

$3F3 

$ 3F4 Power-up byte (see text). -* 

f 3F5 Jur "P instruction to the subroutine that handles Applesoft & 

* 3F6 commands (normally $4C, $58. $FF). 



$3F7 

S3F8 Ju mp ins truction to the subroutine that handles user 

S 3F9 icomtrolH T) commands. 
$3 FA 

S 3F B Jump instruction to the subroutine that handles 

& 3FC non-maskable interrupts {not used on Apple He). 
5»3FD 

S3fJ Interrupt vector (address of the subroutine that handles 

* 3FF interrupt requests (Appendix E). 






L* 
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This chapter is an introduction to the input/output capabilities of 
the Apple lie; the next six chapters discuss these capabilities in 
detail. The remainder of this chapter outlines the common 
elements of I/O processing— standard I/O links and features, 
standard port entry points, protocols and storage locations, and 
direct I/O. 



3. 1 The Standard I/O Links 



When you call one of the character I/O subroutines (COUT and 
RDKEY), the first thing that happens is an indirect jump to an 
address stored in programmable memory. Memory locations 
used for transferring control to other subroutines are sometimes 
called vectors. In this manual, the locations used for 
transferring control to the I/O subroutines are called the 
I/O links. 

In an Apple lie running without an operating system, each 
I/O link is normally the address of the standard input or output 
subroutine. An operating system will typically place addresses 
of its own I/O routines in these link locations instead. 

By calling the I/O subroutines that jump to the link addresses 
instead of calling the standard subroutines directly, you ensure 
that your program will work properly in conjunction with other 
software, such as the operating system or a device driver. The 
I/O links contain the addresses of KEYIN and COUT1 if the 
enhanced video firmware is off (flashing checkerboard cursor), 
and of C3KEYIN and C3COUT1 if that firmware is on (inverse 
solid cursor). 



3.1 The Standard I/O Links fss" 



c 



The Monitor is discussed in 
Chapter 10 



56 



3. i. 1 Changing the Standard I/O Links 

The standard I/O links are two pairs of locations in the Apple lie 
that are used for controlling character input and output. 

Note: Not all operating systems use the standard I/O links. 
For example, Apple Pascal does not use them. 

The link at locations $36 and $37 is called CSW, for character 
output switch. Individually, location $36 is called CSWL {CSW 
Low) and location $37 is called CSWH (CSW High). This link 
holds the starting address of the subroutine the Apple He is 
currently using for single-character output This address is 
normally $FDFO r the address of routine COUT1. 

When you issue a PR#n from BASIC or an n CONTROL-P from 
the Monitor, the Apple lie changes this link address to the first 
address in the ROM memory space allocated to port n. That 
address has the form $CnO0. Subsequent calls for character 
output are thus transferred to the firmware starting at that 
address. When it has finished, the firmware executes an RTS 
(return from subroutine) instruction to return control to the 
calling program. Sometimes a PR#n will cause both input and 
output switches to be changed (as in the 80-column firmware). 

A similar link at locations $38 and $39 is called KSW, for 
keyboard input switch. Individually, location $38 is called KSWL 
(for KSW low) and location $39 is called KSWH (KSW high). 
This link holds the starting address of the routine currently 
being used for single-character input. This address is normally 
$FD1B, the starting address of the standard input routine 
KEYIN. 

When you issue an IN#n command from BASIC or an 
n CONTROL-K from the Monitor, the Apple lie changes this link 
address to $Cn00, the beginning of an I/O firmware subroutine. 
Subsequent calls for character input are thus transferred to that 
firmware. The firmware puts the input character, with its high bit 
set. into the accumulator and executes an RTS (return from 
subroutine) instruction to return control to the program that 
requested input. 

When a disk operating system (DOS or ProDOS) is running, one 
or both of the standard I/O links hold addresses of the disk 
operating system's input and output routines. The operating 
system has internal locations that hold the addresses of the 
character input and output routines that are currently active. 
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Refer to the section on input and 
output link addresses in the 

operating system manuals for 
further details. 



Warning 

If a program that is running with DOS or ProDOS changes the 
standard link addresses, either directly or via IN# and PR# 
commands, the operating system may be disconnected from the 
system. To avoid this, BASIC programs should issue an empty 
PRINT statement with a carriage return (to be sure that what 
follows begins a new line), then another PRINT statement 
containing CONTROL -D and the /A/# or PR# command. 

After changing CSW or KSW, assembly-language programs 
running under DOS should call the subroutine at location $3EA. 
This subroutine transfers the link address to a location inside 
the operating system and then restores the operating system 
link address in the standard link location, 
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3.2 Standard Input Features 



GETLN also provides on-screen 
editing features: see section 3,2,5- 
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The Apple lie's firmware includes two different subroutines for 
reading from the keyboard. One subroutine is named RDKEY 
{read key). It calls the current character input routine (that is, 
the one whose address is stored at KSW). This is normally 
KEYIN or C3KEYIN, which accepts one character from the 
keyboard. The other subroutine is named GETLN {get line). 
GETLN accepts a sequence of characters terminated with a 
carriage return. Thus GETLN allows line-oriented input using the 
current input routine. 



3.2. 1 RDKEY Input Subroutine 

A program gets a character from the keyboard by making a 
subroutine call to RDKEY at memory location $FD0C. RDKEY 
passes control via the input link KSW to the current input 
subroutine, which is normally KEYIN. 

RDKEY displays a cursor at the current cursor position, which 
is immediately to the right of whatever character you last sent 
to the display (normally by using the COUT routine, described 

below). 
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3.2.2 KEYIN Input Subroutine 

KEYIN is the standard input subroutine. When called, it displays 
a cursor, waits until the user presses a key, then returns to the 
calling program with the ASCII code of the key pressed in the 
accumulator. 



3.2.3 GETLN Input Subroutine 



example, an INPUT statement in a BASIC program displays a 
question mark (?) as a prompt. The prompt characters used 
by the different programs on the Apple lie are shown in 
Table 3-1. 
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If the enhanced video firmware is inactive, KEYIN displays a ^^ 

cursor by alternately storing a checkerboard block in the cursor „ 
location, then storing the original character, then the 

checkerboard again. If the firmware is active, C3KEYIN inverts _^ 

the character at the cursor position, *-— 

KEYIN also generates a random number. While it is waiting for 
the user to press a key, KEYIN repeatedly increments the 16-bit 
number in memory locations §4E and $4F. This number keeps 
increasing from to $FFFF (65535), then starts over again at 0. 
The value of this number changes so rapidly that there is no 
way to predict what it will be after a key is pressed. A program 
that reads from the keyboard can use this value as a random 
number or as a seed for a pseudo-random number routine. 

When the user presses a key, KEYIN accepts the character, 
stops displaying the cursor, and returns to the calling program 
with the character in the accumulator. 
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Programs often need strings of characters as input. While it is 

possible to call RDKEY repeatedly to get several characters — 

from the keyboard, there is a more powerful subroutine you can ^ 
use. This routine is named GETLN, which stands for get line, 

and it starts at location $FD6A. Using repeated calls to RDKEY, -- 

GETLN accepts characters from the standard input U»- 
subroutine— usually KEYIN— and puts them into the input buffer 

Section 3.2.5 describes other located in the memory page from $200 to $2FF. GETLN also _ 

features of GETLN. provides the user with on-screen editing and control features. =z - 

The first thing GETLN does when you call it is to display a 
prompting character, called simply a prompt. The prompt 
indicates to the user that the program is waiting for input. E* 

Different programs use different prompt characters, helping to 
remind the user which program is requesting the input. For 

a^mnio an IMP) IT ctaiament in a RAf^in nrnnram disolavs a 
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Control characters echoed by 
GETLN are not executed. 



GETLN uses the character stored at memory location $33 as 
the prompt character. In an assembly-language program, you 
can change the prompt to any character you wish. In BASIC, 
changing the prompt character has no effect, because both 
BASIC interpreters and the Monitor restore it each time they 
request input from the user. 

Note: Applesoft uses GETLN 1 ($FD6F) when a program is 
executing, GETLN1 does not print a prompt. 

Table 3-i. Prompt Characters 

Prompt 

Character Program Requesting Input 

? User's BASIC program {INPUT statement) 

| Applesoft BASIC (Appendix D) 

> Integer BASIC (Appendix D) 

Firmware Monitor (Chapter 10} 

As the user types each character, GETLN sends the character 
to the standard output routine— normally COUT1 —which 
displays it at the current cursor position and then advances the 
cursor to indicate the next character position. 

GETLN stores the characters in its buffer, starting at memory 
location $200 and using the X register to index the buffer. 
GETLN continues to accept and display characters until the 
user presses ( return ) (or (controlX T) to cancel the line). Then 
it clears the remainder of the line the cursor is on, stores the 
carriage-return code to mark the end of the buffer, places the 
cursor at the beginning of the next line, and returns. 

The maximum line-length that GETLN can handle is 
255 characters. If the user types more than this, GETLN sends 
a backslash ( ) and a carriage return to the display, cancels the 
line it has accepted so far, and starts over. To warn the user 
that the line is getting full, GETLN sounds a bell (tone) at every 
keypress after the 248th. 

Note: The Applesoft interpreter accepts only 239 characters. 
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3.2.4 Escape Codes With GETLN 

GETLN has many special functions that you invoke by typing 
escape codes on the keyboard. An escape code is obtained by 
pressing (Iscl , releasing it, and then pressing some other key, 
as shown in Table 3-2. 



present on the Apple tic for compatability. 

Table 3-2. Escape Codes With GETLN. (1) Cursor-control key: see text. (2) This 
code functions only when the enhanced video firmware is active. 

Escape Code Function Notes 

i E-jic. - : Clears the window and homes the 

cursor (places it in the upper-left 
corner of the screen), then exits 
from escape mode. 

[ esc ) (a) or (a) Moves the cursor right one line 

and exits from escape mode. 

(He)® ot © Moves the cursor left one line and 

exits from escape mode. 



(esc) fjf) or (T) Clears to the end of the line; exits 

from escape mode, 

fEscl © or (7) Clears to the bottom of the 

window, exits from escape mode. 
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Note: Be sure to release (esc) right away. If you hold it too -^ 

long, the auto-repeat mechanism will begin, which may t - 

cancel the ESC. 



In escape mode, you can keep using the arrow keys and the 
cursor-motion keys (7), (7), QT)- and (m) without pressing fTscI 
again. This enables you to perform repeated cursor moves by 
holding down the appropriate key. 

When GETLN is in escape mode, it displays an inverse plus 

sign as the cursor. You leave escape mode by typing any key 

other than a cursor-motion key, — 






Note: The escape codes with the arrow keys are the 
standard cursor-motion keys on the Apple tic. The escape 
codes with (7), (T), (k), and ® are tne standard 
cursor-motion keys on the Apple II and II Plus, and are 

nroeant r\r\ tho finnlcl I If* fr\r y-nmmata Kilitw BT 






Iescj (cf) or (T} Moves the cursor down one line mg ^ 

and exits from escape mode. Wm 

fiEscl folor © Moves the cursor up one line; exits 

from escape mode. 
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TaWe 3-2 — Continued. Escape Codes With GETLN 
Escape Code Function 



CescI fcoHTnoL V To") 



[ESC! I' CONTROL >f_E': 

fiscl (controIK oI 



Notes 



flscl CD or © Moves the cursor up one line; 1 

or (esc) (T) remains in escape mode. 

(Hscl Q3 or Q) Moves the cursor left one space; 1 

or (Fsej Q remains in escape mode. 

Ciscl © or (¥) Moves the cursor right one space; 1 

or (esc! remains in escape mode. 

fiscl © or Qn} Moves the cursor down one line; 1 

or ffsc") (T) remains in escape mode. 

CescI (7) Switches to 40-colurnn mode; 2 

activates the enhanced video 
firmware; sets links to C3KEYIN 
and C3COUT1 ; restores normal 
window size (Table 3-5); exits from 
escape mode. 

Switches to 80-column mode; 2 

activates the enhanced video 
firmware; sets links to C3KEYIN 
and C3C0UT1; restores normal 
window size (Table 3-5); exits from 
escape mode. 

Disables control characters; only 
carriage return, line feed. BELL 
and backspace have an effect 
when printed. 

Reactivates control characters. 

Deactivates the enhanced video 2 

firmware; sets links to KEYIN and 
CQUT1; restores normal window 
siie (Table 3-5): exits from escape 
mode. 

Escape sequences can be used in the middle of an input line to 
change the appearance of the screen. They have no effect on 
the input line. 



L -a 



F3 



3.2 Standard Input Features 



1 61 



For an introduction to editing with 
these features, refer to the 
Applesoft Tutorial, 



3.2.5 Editing With GETLN 

Subroutine GETLN provides the standard on-screen editing 
features used by the BASIC interpreters and the Monitor. Any 
program that uses GETLN for reading the keyboard has these 
features. 



The cursor moves ever if the 
deleted character is an {invisible) 
control character. Thus it is 
possible for screen alignment and 
buffer alignment to be different. 



See section 3.2.4. 



Cancel Line 

Any time you are typing a line, pressing ( control "K IT) causes 
GETLN to cancel the line. GETLN displays a backslash ( \ ) and 
issues a carriage return, then displays the prompt and waits for 
you to type a new line, GETLN takes the same action when you 
type more than 255 characters, as described above. 

Backspace 

When you press Q (or (control H ip), GETLN moves its buffer 
pointer back one space, effectively deleting the last character in 
its buffer. It also sends a backspace character to routine COUT, 
which moves the cursor back one space. If you type another 
character now, it will replace the character you backspaced 
over, both on the display and in the line buffer. 

Each time you press Q, it moves the cursor left and deletes 
another character, until you are back at the beginning of the 
line. If you then press Q one more time, you have effectively 
canceled the line, and GETLN issues a carriage return and 
displays the prompt. 

Retype 



GD (or (control K ID) has a function that is complementary to 
the backspace function. When you press Q, GETLN picks up 
the character under the cursor just as if it had been typed on 
the keyboard. You can use this procedure to pick up characters 
that you just deleted by backspacing across them. You can use 
the backspace and retype functions with the cursor-motion 
functions to edit data on the display. 
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3.3 Standard Output Features 



The standard output routine is named COUT (pronounced 
C-out) which stands for character output. COUT normally calls 
COUT1 or C3COUT1, which sends one character to the display, 
advances the cursor position, and scrolls the display when 
necessary. COUT1 and C3COUT1 restrict their use of the 
display to an active area called the text window, described 
below. 



4 3.3. 1 COUT Output Subroutine 



Your program makes a subroutine call to COUT at memory 
location $FDED with a character in the accumulator. COUT then 
passes control via the output link CSW to the current output 
subroutine, normally COUT1 or C3COUT1, which takes the 
character in the accumulator and writes it out. If the 
accumulator contains an uppercase or lowercase letter, a 
number, or a special character, COUT1 or C3COUT1 displays it; 
if the accumulator contains a control character, COUT1 or 
C3COUT1 either performs one of the special functions 
described below or ignores the character. 

Each time you send a character to COUT1 or C3COUT1 , it 
displays the character at the current cursor position, replacing 
whatever was there, and then advances the cursor position one 
space to the right. If the cursor position is already at the 
right-hand edge of the window, COUT1 or C3COUT1 moves it 
to the leftmost position on the next line down. If this would 
move the cursor position past the end of the last line in the 
window, COUT1 or C3COUT1 scrolls the display up one line 
and sets the cursor position at the left end of the new bottom 
line. 

The cursor position is controlled by the values in memory 
locations $24 and $25, These locations are named CH, for 
cursor horizontal, and CV, for cursor vertical. COUT1 and 
C3COUT1 do not display a cursor, but the input routines 
described above do, and they use this cursor position. 
However, changing CV directly will not change the cursor's 
vertical position until the next carriage return or reaching the 
end of the current line causes a call to VTAB (for setting the 
base address within windows). If some other routine displays a 
cursor, it will not necessarily put it in the cursor position used 
by COUT1 orC3COUT1. 
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Warning 

When the video firmware is set for 80-coiumn display, the value 
of CH is kept at and the true horizontal position is stored 
at $57 B. When the 80-column video firmware is active, use 
$57B instead of CH 






Escape codes are described in 
section 3.2.4. 



Escape Codes: see section 3.2.4. 



3,3.2 Control Characters With COUT1 

COUT1 does not display control characters. Instead, the 
control characters listed in Table 3-3 are used to initiate some 
action by the firmware. Other control characters are ignored. 
Most of the functions listed here can also be invoked from the 
keyboard, either by typing the control character listed or by 
using the appropriate escape code. The stop-list function, 
described separately, can only be invoked from the keyboard. 

Table 3-3. Control Characters With COUT1, 



Control 
Character 


ASCII 
Name 


Apple lie 
Name 


Action Taken by COUT1 


CONTROL-G 


BEL 


bell 


Produces a 1000 Hz tone for 
0.1 second. 


CONTROL-H 


BS 


backspace 


Moves cursor position one space 
to the left; from left edge of 
window, moves to right end of 
line above, 


CONTROL-J 


LF 


line feed 


Moves cursor position down to 
next line in window; scrolls if 
needed. 


CONTROL-M 


CR 


return 


Moves cursor posttion to left end 
of next line in window: scrolls if 
needed. 



3.3,3 Control Characters With C3COUT1 

C3COUT1 does not display control characters. Instead, the 
control characters listed in the two parts of Table 3-4 are used 
to initiate some action by the firmware. Other control 
characters are ignored. Most of the functions listed here can 
also be invoked by using the appropriate escape code. The 
stop-list function, described separately, can only be invoked 
from the keyboard. 
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Table 3-4. Control Characters With C3COUT1. (1) Only available when enhanced 
video firmware is active. (2) Only works from the keyboard, (3) Doesn 't work 
from the keyboard. 



H2 

Zj! 



-ij 



Control 
Character 


ASCII 
Name 


Apple He 
Name 


Action Taken by C3COUT1 


Not 


CONTROLS 


BEL 


bell 


Produces a 1000 Hz tone for 
0,1 second. 




CONTROL-H 


BS 


backspace 


Moves cursor position one 
space to the left: from left 
edge of window, moves to 
right end of line above. 




CONTROL-J 


LF 


line feed 


Moves cursor position down 
to next line in window; 
scrolls if needed. 




CONTROL K 


VT 


clear EOS 


Clears from cursor position 
to the end of the screen. 


1.3 


CONTROL-L 


FF 


home 
and clear 


Moves cursor position to 
upper-left corner of window 
and clears window. 


1,3 


CONTRQL-M 


CR 


return 


Moves cursor position to left 
end of next line in window; 
scrolls if needed. 




CONTROL-N 


SO 


normal 


Sets display format normal. 


1.3 


CONTROL-0 


SI 


inverse 


Sets display format Inverse, 


1.3 


CONTROL-Q 


DC1 


40-column 


Sets display to 40-column. 


1.3 


CONTROL-R 


DC2 


80-colurnn 


Sets display to 80-column. 


1.3 


CONTROLS 


DC 3 


stop-list 


Stops listing characters on 
the display until another key 
is pressed. 


2 


CONTROL-U 


NAK 


quit 


Deactivates enhanced video 

firmware. 


1,3 


CONTROL-V 


SYN 


scroll 


Scrolls the display down one 
line, leaving the cursor in the 
current position. 


1,3 


CONTROL-W 


ETB 


scroll-up 


Scrolls the display up one 

line, leaving the cursor in the 
current position. 


1,3 


CONTROL-X 


CAN 


disable 
MouseText 


Disable MouseText 
character display; use 
inverse uppercase. 




CONTROL-Y 


EM 


home 


Moves cursor position to 
upper-left corner of window 
(but doesn't clear). 


1.3 


CONTROL-Z 


SUB 


clear line 


Clears the line the cursor 


1,3 



position is on. 
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Table 3-4— Continued, Control Characters With C3C0UT1 



Control 
Character 

CONTROL-I 



CONTROL-I 



ASCII Apple tic 
Name Name 

ESC enable 

MouseText 



CONTROLA FS fwd. space 



GS clear EOL 



CONTROL-- US up 



Action Taken by C3COUT1 Notes 

Map inverse uppercase 
characters to MouseText 
characters. 

Moves cursor position one 1,3 
space to the right; from right 
edge of window, moves it to 
left end of line below. 

Clears from the current 1,3 

cursor position to the end of 
the line (that is, to the right 
edge of the window). 

Moves cursor up a line, no 
scroll 



_ 

— 
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3.3.4 The Stop-List Feature 

When you are using any program that displays text via COUT1 
or C3COUT1 , you can make it stop updating the display by 
pressing ( control H P (that is, by holding down ( control ) 
while pressing ($)). Whenever COUT1 or C3COUT1 gets a 
carriage return from the program, it checks for ( control H ~s~). If 
it has been pressed, COUT1 or C3COUT1 stops and waits for 
another keypress. Then it continues normally. The character 
code of the key you pressed to resume displaying is ignored 
unless it is ( control H ~cT). COUT1 or C3COUT1 passes 
CONTROL-C back to the program; if it is a BASIC program, 
this enables you to terminate the program while in stop-list 
mode. 



3.3.5 The Text Window 

After you start up the computer or perform a reset, the 
firmware uses the entire display. However, you can restrict 
video activity to any rectangular portion of the display you 
wish. The active portion of the display is called the text 
window. COUT1 or C3COUT1 puts characters only into the 
window; when it reaches the end of the last line in the window, 
it scrolls only the contents of the window, 
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You can set the top, bottom, left side, and width of the text 
window by storing the appropriate values into four locations in 
memory. This enables your programs to control the placement 
of text in the display and to protect other portions of the screen 
from being written over by new text. 

Memory location $20 contains the number of the leftmost 
column in the text window. This number is normally 0, the 
number of the leftmost column in the display. In a 40-column 
display, the maximum value for this number is 39 
(hexadecimal $27); in an 80-column display, the maximum value 
is 79 (hexadecimal $4F). 

Memory location $21 holds the width of the text window. For a 
40-column display, this value is normally 40 (hexadecimal $28); 
for an 80-column display, it is normally 80 (hexadecimal $50). 

Warning 

Be careful not to let the sum of the window width and the 
leftmost position in the window exceed the width of the display 
you are using (40- or 80-columns). If this happens, it is possible 
for COUT1 or C3COUT1 to put characters into memory 
locations outside the display page, possibly destroying 
programs or data. 

Memory location $22 contains the number of the top line of the 
text window. This is normally 0, the topmost line in the display. 
Its maximum value is 23 (hexadecimal $17). 

Memory location $23 contains the number of the bottom line of 
the screen, plus 1. It is normally 24 (hexadecimal $18) for the 
bottom line of the display. Its minimum value is 1 . 

Table 3-5 summarizes the memory locations and the possible 
values for the window parameters. 

Warning 

Pascal does not use this method of supporting window widths. 
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Table 3-5. Text Window Memory Locations 



Window 
Parameter 



Left Edge 

Width 

Top Edge 

Bottom 
Edge 



SOcol. 
Dec Hex 

32 $20 



33 
34 

35 



S21 
S22 
S23 



Both these display character sets 
are described in Chapter 5, 



Minimum 
Location 



Normal Values: 



Maximum Values: 



Dec 




1 



Hex 

$0 
SO 

so 

$1 



Value 
Dec Hex 





40 



24 



SO 
S28 
SD 
$18 



40col, 
Dec Hex 

SO 

80 S50 
so 

24 £18 



40col. 
Dec Hex 



SOcol. 
Dec Hex 



39 
40 
23 
24 



$27 
$28 
S17 
$18 



79 
80 
23 
24 



S4F 
S50 
S17 



3.3.6 Normal, Inverse, and Flashing Text 

The form of a displayed character depends on two things: what 
value is stored in zero page location £32 (the inverse flag), and 
whether the enhanced video firmware is off or on. The effects 
of the inverse flag are discussed in the next two subsections. 

If the enhanced video firmware is off, the Apple lie displays 
what is called the primary character set; if the video firmware is 
on, the Apple lie displays what is called the alternate character 
set. 

The primary character set includes normal (light on dark), 
inverse (dark on light), and flashing (alternating normal and 
inverse) characters. Lowercase inverse characters are not 
included in this set. 

The alternate character set includes normal and inverse 
characters (including lowercase inverse), and a set of icons 
called MouseText. Flashing characters are not included in this 
set. 

To display a character, load it in the accumulator, and then 
jump to the character-output subroutine COUT. For example, to 
display the character corresponding to $C8 

LDA #$C8 

JSR COUT 

Primary Character Set Display 



text. 
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Subroutine COUT1 (the standard output link when enhanced 
video firmware is off) can display text in normal, inverse, or 
flashing format, but cannot display inverse or flashing lowercase 
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For a brief explanation of logical 
functions, refer to Appendix H, 



-a 



MouseText see Chapter 5, 



See section 5.2.2. 



If the value of the character is greater than or equal to $A0, the 
value is logically ANDed with the value of the inverse flag (at 
location $32), then displayed. 

If the inverse flag value is 255 (hexadecimal $FF), the character 
is displayed in normal format; if the value is 63 
(hexadecimal $3F), the character is displayed in inverse format. 
If the value is 127 (hexadecimal $7F) the character is displayed 
in flashing format. 

Note: To avoid unusual character display results, use only 
the three values $3F, $7F and $FF. 

Character values from S80 through $9F are interpreted as 
control characters and are executed, if possible. 

Character values from $00 through $7F are all display 
characters, not control characters. 

Alternate Character Set Display 

Subroutine C3COUT1 (the standard output link when the 
enhanced video firmware is active) can display characters in 
normal or inverse format, and can display a set of icons called 
MouseText. 

If the character is in the range $00 through S1F or $80 through 
$9F, it is interpreted as a control character and not displayed. 
Values $20 through $7F and SAO through $FF are displayed. 

If inverse flag (location $32) bit 7 is 1 , the character value is left 
alone. If inverse flag bit 7 is 0, the character value is ANDed 
with $7F (turning off bit 7) to make it display as an inverse 
character. 

If MouseText has not been turned on, then the values 
$40 through $5F are mapped to values $00 through $1F, so 
they display as the inverse uppercase set. If MouseText has 
been turned on, the values $40 through $5F are left unchanged, 
and they display as MouseText icons. 

Warning 

Use only $3F, $7F or $FF in location $32. Other values will 

cause unpredictable results. 
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3.4 Port I/O 



Apple lie is a member of the Apple II family of computers; 
however, unlike the Apple II, II Plus and lie, the Apple lie does 
not have peripheral connector slots. In place of these, it has 
ports — the equivalent of firmware interface cards installed in 
slots. 






3 A. 1 Standard Link Entry Points 

To maintain compatibility with existing software and its 
protocols, each port's I/O firmware has the same standard 
entry points ($CnOO) as its equivalent slot would have. 
Table 3-6 shows these equivalents, as well as listing the 
chapter where each port is described. 

Section 3.1 describes under what conditions these entry 
addresses are placed in CSW and KSW. For example, issuing 
PR'n or IN'n changes the output and input links, 
respectively, so that subsequent output or input is handled by 
the firmware starting at address SCnOO, and thus goes to or 
comes from the selected device. 
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Table 3-6. Port Characteristics 






5r 


Port 


Entry 
Point 


Port 
Connector 


Use 


Chapter 


£ 


1 


SC100 


Serial port 1 


Printers 


7 


2 


SC200 


Serial port 2 


Communication 





l— 


3 


SC300 


Video connectors 


Enhanced video 
firmware 


5 


!- 


-■ 


SC400 


Mouse 


Mouse 


9 


£ 


5 


SC500 


Reserved 






5 


SC600 


Disk drives 


Built-in and 
external drives 


S 


r^ 


7 


SC70O 


No device 


Externa! drive 
startup {under 
ProDOS only) 


6 


Zl 



Note: The addresses shown in Table 3-6 are not entry points 
fn the sense that you can send characters to be printed by 
sending them to JSR $CnOO. 
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5.4.2 Firmware Protocol 

Besides the standard link address, there is also a standard 
firmware protocol that provides a table of device identification 
and entry points to standard and optional firmware subroutines 
(Table 3-7). 

Each table begins with identification bytes. Then, starting with 
address $CnOD, each byte in the table represents the low-order 
byte of the entry-point address of a firmware routine. The 
high-order byte of the address is SCn, where n is the port 
number. Using these byte values, a program can construct its 
own jump table for subroutine calls. 

On entry, all routines require that the X register contain $Cn 
{n is the port number), and that the Y register contain $n0. 

On exit, all routines return an error code in the X register 
(0 means no error occurred; 3 means the request was invalid). 
The carry bit in the program status register usually contains a 
reply to a request code (0 means no: 1 means yes). 

All of the Apple He ports except the disk port conform to this 
protocol. 
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Table 3-7, 
Address 

SCnOS 
SCn07 
SCnOB 

SCnOC 



Firmware Protocol Locations 

Value Description 



SCnOD 

$CnOE 

SCnOF 
$Cn10 

SCn 11 



$38 
$18 
$01 
Sci 



ii 
n 

WW 



Pascal firmware card/ port identifier 

Pascal firmware card/port identifier 

Generic signature byte of a firmware card/port 

Device signature byte: i is an identifier (not 
necessarily unique). 

c = device class (not all used on the Apple He): 



SCnii rs the initialization entry address (PINIT), 

$Cnrr is the read routine entry address (PREAD). 
(Returns character read in A register) 

$Cnww is the write routine entry address 
(PWRITE). {Enter with character to write in 
A register) 

SCnss is the status routine entry address 
(PSTATUS). (Enter with request code in A 
register: to ask "Are you ready to accept 
output?" or 1 to ask "Do you have input ready?' 

$00 if additional address bytes follow; 
nonzero if not 



c 

e 



so 


reserved 


fcr 


$1 


printer 




S2 


hand control or other X-Y device 


±1 


S3 


serial or parallel I/O card/port 


$4 


modem 


^ 


S5 


sound or speech device 


36 
|7 


clock 
mass-storage device 


e 


50 


80-column card/port 




$9 


network or Pus interface 


$A 

SB-F 


special purpose (none of the 
above) 

reserved 



£ 



&- 



£ 



"721 



Chapter 3: Introduction to Apple lie I/O 



gZ 



=3 

^3 



For more information, refer to trie 
hardware page memory map in 
Appendix B, 
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3.4.3 Port f/O Space 

By a convention used in other Apple II series machines, each 
port or slot has exclusive use of sixteen memory locations of 
the form SC080 + #n0, where n is the port or slot number. 
These locations are set aside for data input and output. 
Table 3-8 lists the port I/O space used in the Apple lie. 



Table 3-8, 


Pod I/O Locations 


Port 


Locations 


1 


SC090-SC09F 


2 


SCQAQ-SCOAF 


6 


SC0E0-SC0EF 



3.4.4 Port ROM Space 

In the Apple II and lie, one 256-byte page of memory space is 
allocated to each slot. This space is used for read-only memory 
(ROM or PROM) with driver programs that control the 
operation of input/output devices, as outlined in Table 3-7. On 
the Apple lie. this space is dedicated to port firmware. 
However, I/O ROM space in the Apple lie is used as efficiently 
as possible, and so there is not a strict correspondence 
between firmware for port n and the $CnOO space, except as 
regards entry points. 

3.4.5 Expansion ROM Space 

The 2K-byte memory space from $C800 to $CFFF in the 
Apple He — called expansion ROM space on Apple II, It Plus 
and lie — contains the enhanced video firmware and port and 
memory transfer subroutines. Unlike the Apple II, II Plus, or lie, 
the Apple lie always has this space switched in. 

3.4.6 Port Screen-Hole RAM Space 

There are 128 bytes of memory (64 in main memory. 64 in 
auxiliary memory) allocated to the ports, eight bytes per port, 
as shown in Table 3-9. These bytes are reserved for use by the 
system, except as described in Chapters 4 through 9. 

These addresses are unused bytes in the RAM memory 
reserved for text and low-resolution graphics displays, and 
hence they are sometimes called screen holes. These particular 
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locations are not displayed on the screen and their contents are 
not changed by the built-in output routines. In other words, they 
are used by the output routines but they are not part of the 
video display. 



- 



Warning 

All the screen holes in auxiliary memory, and many of them in 
main memory, are reserved for special use by Apple He 
firmware — for example to store initialization information. Do not 
use any locations marked reserved in this manual 
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Table 3-9. Port Screen-Hole Memory Locations 



Base 
Address 


Ports 
1 


2 


3 


4 


5 


6 


7 


$0478 


$0479 


$047A 


$047B 


S047C 


$047D 


$047 E 


$047F 


$04F8 


$04F9 


$04FA 


$04FB 


$04 FC 


$04 FD 


$04 FE 


$04FF 


$0579 


$0579 


$057A 


$057B 


$057C 


$057 D 


S057E 


$057 F 


$05F8 


$05F9 


$05FA 


$05 FB 


$05FC 


$05FD 


$05 FE 


S05FF 


$0678 


S0679 


S067A 


$067 B 


$067C 


$067D 


$067 E 


S067F 


$06 F8 


5Q6F9 


$06 FA 


$06 FB 


$06FC 


$06FD 


$06FE 


$06FF 


$0778 


$0779 


S077A 


S077B 


S077C 


S077O 


$077E 


$077F 


S07F8 


$07F9 


$07 FA 


$07 FB 


S07FC 


$07 FD 


S07FE 


$07FF 



Port firmware use of these RAM locations and their assigned 
hardware addresses appear in the six chapters that follow this 
one. 



3,5 Interrupts 



Appendix E gives a full description 
of interrupt handling on ttie 
lie 



When the IRQ line on the 65C02 microprocessor is activated, 
the 65C02 transfers control through the vector in locations 
$FFFE-$FFFF of ROM or whichever bank of RAM is switched in 
{Chapter 2). If ROM is switched in, this vector is the address of 
the Monitor's interrupt handler, which determines whether the 
request is due to an interrupt that should be handled internally. 
If so, the Monitor handles it and then returns control to the 
interrupted program. 

If the interrupt is due to a BRK ($00) instruction, control is 
transferred through the BRK vector ($3F0-$3F1). Otherwise, 
control is transferred through the IRQ vector ($3FE-$3FF). 
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This chapter describes how to use two of the Apple He's built-in 
devices: the keyboard and the speaker. 



4. 7 Keyboard Input 









Port Number 


5 






Commands 


^ 






Initial 
Characteristics 


^ 






Hardware 
Locations 

scooo 


% 






SC0 10 

SC060 


■■Bl 


Game in 
Chapter 


put switches: see 
9. 


SC061 
SC062 


% 
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Table 4-1 describes the overall characteristics of the keyboard. 
Monitor keyboard support includes the three standard input 
routines described in Chapter 3. 

Table 4-1, Keyboard Input Characteristics 

None 

Keyboard is always on, in the sense that any keypress 
generates a KSTRB. 

Reset routine clears trie keyboard strobe and sets the 
keyboard as the standard input device (that is, sets KSW to 
point to RDKEY). 



Description 

Keyboard data and strobe 

Any-key-down flag and Clear-strobe switch 

40-column switch status on bit 7; 1 = 40-column display 
switch down 

[j5D status on bit 7; 1 = pressed (also game input switch 0} 

fit status on bit 7; 1 pressed 



m 



GETLN, GETLN1, and RDKEY: see 
Chapter 3. 



Table 4- 1 — Continued. Keyboard Input Characteristics 



Monitor Firmware Routines 
Location Name 

SFD6A 

$FD67 



SFD6F 

$FD1B 
$FD35 
$FD0C 

Use of Other 
Pages 

Page 2 



Description 
GETLN Gets an input line with prompt. 

GETLNZ Gets an input fine with preceding carriage 

return. 

GETLN 1 Gets an input line, but with no preceding 

prompt 

KEYIN The keyboard input subroutine 

RDCHAR Gets an input character or escape code, 
RDKEY The standard character input subroutine 



The standard character string input buffer (see GETLN 
description) 
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For a description of how the 
keyboard strobe works, refer to 
Appendix E 






4. 1. 1 Reading the Keyboard 

The keyboard encoder and ROM generate all 128 ASCII codes, 
so all the special character codes in the ASCII character set are 
available from the keyboard. Machine-language programs obtain 
character codes from the keyboard by using RDKEY, which 
reads a byte from the keyboard-data location shown in 
Table 4-1. 

Here is how reading the keyboard is done: 

1. To see if a key has been pressed, test bit 7 at 
address $CQ00\ 

2. When that bit goes to a 1 , the low-order seven bits are the 
character. 

3. Clear the high bit at SC00O by reading or writing anything to 
address SC010. 

$C010 has another function: its high bit is a 1 while a key is 
pressed (except the Apple keys, ( control ) , (shift] , ( caps-lock ) , 
and (reset) ). Bit 7 at this location is therefore called 
any-key-down. 

Any time you read the any-key-down bit at $C010, you also 
clear the keyboard strobe bit at $C000. If your program needs 
to read both the flag and the strobe, it must read the strobe bit 
first. 

After the keyboard strobe has been cleared, it remains low until 
another key is pressed. 



4.1 Keyboard Input 



1 79 



Table 4-2 shows the ASCII codes for the keys on the Apple lie 
keyboard. If the strobe bit is set, add $80 to these values. 

Table 4-2. Keys and ASCII Codes 



E 



Codes are shown here In 
hexadecimal; to find the decimal 
equivalents, refer to section H.6. 



Key 


Normal 

7F 


Char 
DEL 


Control 
7F 


Char 

DEL 


Shut 

7F 


Char 
DEL 


Both 

7F 


Char 
DEL 


s 


1 DELETE i 


cz> 


08 


BS 


08 


BS 


OS 


BS 


98 


BS 


44* 


(tab! 


09 


HT 


09 


HT 


09 


HT 


09 


HI 


CD 


0A 


LF 


0A 


LF 


0A 


LF 


OA 


LF 


_^ 


CD 


OB 
0D 


VT 
CR 


OB 

OD 


VT 
CR 


OB 

OD 


VT 

CR 


OB 
OD 


CR 


^^^^^ 


i RETURN i 





15 


NAK 


15 


NAK 


IS 


NAK 


15 


NAK 


CUD 


1B 


ESC 


1B 


ESC 


IB 


ESC 


1B 


ESC 




SPACE 


20 
27 


SP 


20 
27 


SP 


20 

22 


SP 


20 
22 


SP 


(P 




2C 


• 


2C 


■ 


3C 




3C 


< 


ct 


-- 


20 


• 


1F 


US 


5F 


_ 


1F 


US 


fer 1 - 


.> 


2E 


• 


2F 


I 


3E 


> 


3E 


> 


-- 


n 


2F 


/ 


2F 


1 


3F 


9 


3F 


V 


B= 


0, 


30 





30 





29 


) 


29 


I 


.. 


1' 


31 


1 


31 


1 


21 


i 


2! 


' 


e= 


2@ 


32 


2 


00 


NUL 


40 


© 


00 


NUL 




3# 
4$ 


33 
34 


3 

4 


33 
34 


3 
4 


23 
24 


2 


23 
24 


s 


t£ 


5% 


35 


5 


35 


5 


25 


% 


?H 


% 


!? 


6' 


35 


e 


IE 


RS 


5E 


■ 


IE 


RS 


?& 


37 


7 


37 


7 


26 


A 


26 


ft 


,- 


fi* 


38 


8 


38 


s 


2A 


* 


2A 


• 


H- 


9| 


39 

3F: 


9 


39 
38 


9 


28 
3A 


I 


2B 
3A 


( 




= + 


3D 


- 


3D 




2B 


I 


2B 


+ 




I 


58 


1 


1B 


ESC 


7B 


I 

i 


1R 


ESC 


H= 


— 


5C 


\ 


1C 


FS 


7C 


I 


1C 


FS 


J 


5D 


I 


1D 


GS 


7D 


I 


1D 


GS 


£ 




60 




60 


* 


7C 


" 


7E 


- 
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Table 4-2- 


-Continued. Keys and ASCII Codes 










Key 


Normal 


Char 


Control 


Char 


Shift 


Char 


Both 


Char 


A 


61 


a 


D1 


SOH 


41 


A 


01 


SOH 


B 


62 


b 


02 


STX 


42 


B 


02 


STX 


C 


63 


c 


OS 


ETX 


43 


c 


03 


ETX 


D 


64 


d 


04 


EOT 


44 


D 


04 


EOT 


E 


65 


a 


OS 


ENQ 


45 


E 


05 


ENQ 


F 


66 


f 


06 


ACK 


46 


F 


06 


ACK 


G 


67 


g 


7 


BEL 


47 


G 


07 


BEL 


H 


68 


h 


0B 


BS 


48 


H 


08 


BS 


1 


^ 


i 


og 


HT 


49 


I 


09 


HT 


J 


6A 


] 


OA 


LF 


4A 


J 


OA 


LF 


K 


6B 


k 


0B 


VT 


4B 


K 


OB 


VT 


l 


6C 


I 


oc 


FF 


4C 


L 


OC 


FF 


M 


6D 


.•■--l 


00 


CR 


40 


M 


OD 


CR 


N 


6£ 


n 


OE 


SO 


4E 


N 


OE 


SO 





F.P 


D 


OF 


SI 


4F 





OF 


SI 


p 


70 


P 


10 


OLE 


50 


P 


1G 


DLE 


Q 


71 


q 


11 


DC1 


51 


Q 


11 


DC1 


R 


n 


r 


12 


DC2 


52 


R 


12 


DC2 


3 


73 


s 


13 


DC3 


53 


S 


i a 


DC3 


T 


7 A 


t 


14 


DC4 


54 


1 


14 


DC4 


U 


n 


u 


15 


NAK 


55 


u 


15 


NAK 


V 


76 


V 


1b 


SYN 


56 


V 


15 


SYN 


w 


77 


w 


17 


ETB 


57 


w 


17 


ETB 


x 


78 


X 


18 


CAN 


58 


X 


18 


CAN 


v 


79 


y 


19 


EM 


59 


V 


19 


EM 


Z 


7A 


2 


1A 


SUB 


5A 


z 


1A 


SUB 
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Keystrokes can also generate 
interrupts; see Appendix E. 



This restarting process is called 
the reset routine, and is described 
in Chapter 2. 



For information on how to have 
programs interpret keystrokes in a 
standard way, refer to the 
Apple It Design Guidelines listed in 
the Bibliography. 



There are several special-function keys that do not generate 
ASCII codes. For example, you cannot read (control) , ( shift ) t 
and (caps-lock) directly, but pressing one of these keys alters 
the character codes produced by the other keys. Programs can 
also read the status of (_oJ and (W) when checking keyboard 
input, and, if one or both of them is pressed, branch to a 
special routine, such as a help program. 

Another key that doesn't generate a code is (reset) , located at 
the upper-left corner of the keyboard; it is connected directly to 
the Apple lies circuits. Pressing ( reset j with ( control ) 
depressed normally causes the system to stop whatever 
program it's running and restart itself. 

4. 1.2 Monitor Firmware Support 

Chapter 3 describes the three standard Monitor input routines 
serving the keyboard: GETLN, READKEY and KEYIN. This 
section discusses the three other Monitor routines available. 

GETLNZ 

GETLNZ (at address $FD67) is an alternate entry point for 
GETLN that sends a carriage return to the standard output, 
then continues into GETLN. 

GETLN1 

GETLN1 {at address SFD6F) is an alternate entry point for 
GETLN that does not issue a prompt before it accepts the input 
line. However, if the user cancels the input line with too many 
backspaces or with ( control K x~). then GETLN 1 issues the 
prompt at location $33 when it gets another line. 

RDCHAR 

RDCHAR (at address $FD35) is a subroutine that gets 
characters from the standard input subroutine, and also 
interprets the escape codes listed in Chapter 3, 

If the enhanced video firmware is active, (3 ( {control K ip) 
causes a character to be read from the screen location and 
returned. 
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4.2 Speaker Output 



Electrical specifications of the 
speaker circuit appear in 
Chapter 11. 



The Apple He has a speaker mounted toward the front of the 
bottom plate. The speaker is connected to a soft switch that 
toggles; it has two states, off and on, and it changes from one 
to the other each time it is accessed. Table 4-3 describes the 
speaker output characteristics. 



Table 4-3. Speaker Output Characteristics 



Port Number 


None 


Commands 

Initial 
Characteristics 


Some programs sound the speaker in response to 
CONTROL-G. 

Reset routine sounds the speaker. 


Hardware 
Location 


Description 


SC030 


Toggle speaker (read only) 


Monitor Firmware Routines 

Location Name Description 


SFBDD 


BELLI Sends a beep to the speaker. 


SFF3A 


BELL Sends CONTROL-G to the current output 



4.2. f Using the Speaker 

If you switch the speaker once, it emits a click; to make longer 
sounds, you access the speaker repeatedly. You should always 
use a read operation to toggle the speaker. If you write to this 
soft switch, it switches twice in rapid succession. The resulting 
pulse is so short that the speaker doesn't have time to 
respond; it doesn't make a sound. 

The switch for the speaker uses memory location SC030. You 
can make various tones and buzzes with the speaker by using 
combinations of timing loops in your program. 
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BELLI 



BELL 

The Monitor routine BELL (at location $FF3A) writes a bell 
control character (ASCII CONTROL-G) to the current output 
device. This routine leaves the accumulator holding $87. 



J 



4.2,2 Monitor Firmware Support | 

See Chapter 3, The Monitor supports the speaker with one simple routine, L-4 

BELLI. A related routine, BELL, supports the current output 
device — the one that CSW points to. 



i 



BELLI (at address $FDBB) makes a beep through the speaker L*4 

by generating a 1 kHz tone in the Apple lie's speaker for 
0.1 second. This routine scrambles the A and X registers. 
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NTSC stands for National 
Television Standards Committee, i 
group that formulates broadcast 
and reception guidelines used by 
the USA and several other 
countries. 



The primary output device of the Apple lie is the video display. 
You can use any ordinary video monitor, either color or 
monochrome, to display video information from the Apple lie. 
An ordinary monitor is one that accepts composite video 
compatible with the standard set by the NTSC. If you use 
Apple lie color graphics with, for example, a black-and-white 
monitor, the display will appear as black, white, and three 
shades of gray. 

If you are only using 40-column text and graphics modes, you 
can use a television set for your video display. If the TV set has 
an input connector for composite video, you can connect it 
directly to your Apple lie; if it does not, you must attach an RF 
video modulator between the Apple lie and the television set. 

Note: The Apple lie can produce an 80-column text display. 
However, if you use an ordinary color or black-and-white 
television set, 80-column text will be too blurry to read. For a 
clear 80-column display, you must use a high-resolution video 
monitor with a bandwidth of 14 MHz or greater. 
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Table 5-1 is a summary of the video output ports 
characteristics and a guide to other information In this chapter. 

Table 5-1. Guide to the Information in This Chapter 



Port Number 

Commands 

Initial Characteristics 



Hardware Locations 
Monitor Firmware Routines 
I/O Firmware Entry Points 



Output port 3 

Figure 5-3 

Figure 5-2 

Note: II a program is to use the 

enhanced video firmware, it should 
turn it on and then immediately check 
the 80/40 switch. If the switch is in 
the 40 position, the program should 
issue a CONTROL-Q. 

See Table 5-7 

See Table 5-8 

See Table 5-9 
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5. 1 Specifications 



Table 5-2 summarizes the specifications for the video display, 
and provides a further guide to other information in this chapter. 



Table S-2. Video Display Specifications 
Display modes 



Text capacity 
Character set 
Display formats 
Low- resolution graphics 
High-resolution graphics 

Double-high-resolution graphics 



40-column text; map: Figure 5-5 
80-column text; map: Figure 5-6 

Low- resolution color graphics: 
map: Figure 5-7 

High-resolution color graphics; 
map: Figure 5-8 

Double-bigh-resolutlon color graphics; 
map: Figure 5-9 

24 lines by 80 columns (character 
positions) 

96 ASCII characters (uppercase and 
lowercase) 

Normal, Inverse, Flashing. MouseText 
(Table 5-3) 

16 colors (Table 5-4) 40 horizontal by 
48 vertical; map: Figure 5-7 

6 colors (Table 5-5) 140 horizontal by 
192 vertical (restricted); 

black-and-white; 260 horizontal by 
192 vertical; map: Figure 5-8 

16 colors (Table 5-6) 140 horizontal 
by 192 vertical (no restrictions); 

black-and-white: 560 horizontal by 
192 vertical; map: Figure 5-9 



The video signal produced by the Apple He is NTSC-compatible 
composite color video. It is available at two places: the 
RCA-type phono jack on the back of the Apple He, and the 
15-pin D-type connector on the back panel. Use the RCA-type 
phono jack to connect a video monitor or the DB-15 connector 
for an external video modulator; use the 15-pin connector to 
attach video expansion hardware (section 1 1 .9.5). 

Either of the two text modes can display all 96 ASCII 
characters: uppercase and lowercase letters, numbers, and 
symbols. 



5.1 Specifications 
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5.2 Text Modes 



MouseText: see section 5.2.2. 



The text characters displayed include the uppercase and 
lowercase letters, the ten digits, punctuation marks, and special 
characters. Each character is displayed in an area of the screen 
that is seven dots wide by eight dots high. The characters are 
formed by a dot matrix five dots wide (with a few exceptions, 
such as underscore), leaving two blank columns of dots 
between characters in a row. Except for lowercase letters with 
descenders, the characters are only seven dots high, leaving 
one blank line of dots between rows of characters. 

The normal display has white (or other monochrome color) dots 
on a dark background. Characters can also be displayed as 
black dots on a white background; this is called inverse format. 



5.2. 1 Text Character Sets 

The Apple lie can display either of two text character sets: the 
primary set and an alternate set (Table 5-3). The forms of the 
characters in the two sets are actually the same, but the 
available display formats are different. The display formats are 

• normal, with white dots on a black screen 

• inverse, with black dots on a white screen 

• flashing, alternating between normal and inverse. 

With the primary character set. the Apple lie can display 
uppercase characters in all three formats: normal, inverse, and 
flashing. Lowercase letters can only be displayed in normal 
format. The primary character set is compatible with most 
software written for the Apple II and II Plus, which can display 
text in flashing format but don't have lowercase characters. 

The alternate character set sacrifices the flashing format for a 
complete inverse format. With the alternate character set, the 
Apple lie can display uppercase letters, lowercase letters, 
numbers, and special characters in either normal format or 
inverse format. It can also display MouseText. 

You select the character set by means of the alternate-text soft 
switch, described in section 5.6. Table 5-3 shows the character 
codes in decimal and hexadecimal for the Apple He primary and 
alternate character sets in normal, inverse, and flashing formats. 
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To identify particular characters 
and values, refer to Table 4-2. 



Each character on the screen is stored as one byte of display 
data. The low-order six bits make up the ASCII code of the 
character being displayed. The remaining two (high-order) bits 
select format and the group within ASCII (section 3,3,6). 



Table 5-3. The Display Character Sets 

Primary Character Set 
Hex Values Character Type Format 



Alternate Character Set 
Character Type Format 



SQ0-S1F 


Uppercase letters 


Inverse 


Uppercase letters 


Inverse 


$20-$3F 


Special characters 


Inverse 


Special characters 


Inverse 


$40-$5F 


Uppercase letters 


Flashing 


MouseText 
(section 5.2.2) 




S60-S7F 


Special characters 


Flashing 


Lowercase letters 


Inverse 


SS0-S9F 


Uppercase letters 


Normal 


Uppercase letters 


Normal 


SAO-SBF 


Special characters 


Normal 


Special characters 


Normal 


SCO-SDF 


Uppercase letters 


Normal 


Uppercase letters 


Normal 


$E0-$FF 


Lowercase letters 


Normal 


Lowercase letters 


Normal 



5.2.2 MouseText 

The character-generator ROM can display 32 graphics 
characters called MouseText in place of the inverse uppercase 
series from $40 through $5F. These graphics are especially 
convenient to use with a mouse, since they can be generated 
by character codes instead of groups of high -resolution byte 
values, and they can be moved around quickly. To use 
MouseText characters, do the following: 

1. Turn on the enhanced video firmware: issue PR#3 or 
ESC 8 or ESC 4. 

2. Set inverse mode: use the INVERSE command or put $3F in 
location $32, or print CONTROL-O. 

3. Turn on the MouseText feature: PRINT CHRSC27}; or 
pass $18 to COUT in the accumulator. 

4. Print the uppercase letter (or other ASCII character in the 
range $40-$5F: @ [ \ ] * or _ ) that corresponds to the 
MouseText character you want, using COUT1. 
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5. Turn off the MouseText feature: PRINT CHR$(24);or 
pass $18 to COUT1 in the accumulator. 

6. Set normal mode: use the NORMAL command or put $FF in 
location $32, or print a CONTROL-N. 

Here is a sample Applesoft program that prints all the 
MouseText characters: 



10 DS*CHR$C4> 

20 PRINT PRINT D$;"PR#3" 

30 INVERSE 

40 PRINT 

CHRIC27J ;"@ABCDEFGHIJKLriNQPQRSTUVWXYZ(:\ ]*-"■, 

50 PRINT CHRSC24); 

60 NORMAL 

Simulated MouseText characters and their corresponding ASCII 
characters are shown in Figure 5-1 . 

Figure 5-1. MouseText Characters 
@ A B C D E FG 

<- ... -i v ~ +i m ~± 

M 

£ +: *. - l -> 

P Q R S T U 

c => | ♦ Z * 3 I 



K L M N O 



U V W 



2 I \ ] 



E 

- 

I— 



Chapter 5: Video Display Output 






5 
j 



-4 

3 



5.2.3 40 -Column Versus 80-Column Text 

The Apple lie has two modes of text display: 40-column and 
80-column. The number of dots in each character does not 
change, but the characters in 80-column mode are only half as 
wide as the characters in 40-column mode. Compare the two 
displays in Figure 5-2. On an ordinary color or black-and-white 
television set, the narrow characters in the 80-column display 
blur together; you must use the 40-column mode to display text 
on a television set. 
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Figure 5-2. 40-Cotumn and 80-Column Text Display 
(With Alternate Character Set) 



3LIET tf> 100 

\i REM APPLESOFT CHARACTER DEMO 

>Q jteXT : HOME ; k>\w 
75 PRINT • PRINT "Applesoft Uhar 

acter Demo" 
4 ^ print = PRINT "Which character 

-it — " 
50 PRINT ' INPUT "Primary <P> or 

Alternate (h) ?IjA$ _ 
6© IF LEN CA$> ■ 1 THEN 59 
-": LET At = LEFT* £M - 
f$ IF hi = ;i P !i THEN POKt 491S€, 

£8 IF AS - £i H 5 ' THEN POKE 49167, 


7 : Hi PRINT hI .. . . printing th 
e same 1 in©* first" 

:C'Q PR IN! E; in NORMAL., then _ - 
RSE , then FLASH ' PF INT 
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Figure 5-3 illustrates the methods of switching text display 
modes, and the characteristics of each. 



Figure 5-3. Text Mode Characteristics and Switching 
Power On 



[ES^ ( CCW ROL]-(Q]| 

Resets lull 
40-column window 



Cursor: checkerboard 
nput Hook: KEYIN 
Output Hook: COUT1 
Window: 40 columns. 

24 lines 
Character Set: primary 




Cursor: square box 
Input Hook: C3KEYIN 
Output Hook: C3COUT1 
Window: 40 columns, 

24 lines 
Character Set: alternate 



Cursor: narrow box 
Input Hook: C3KEYIN 

Output Hook: C3COUT1 
Window: 80 columns, 

24 lines 
Character Set: alternate 
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5.3 Graphics Modes 
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The Apple lie can produce video graphics in any of three 
different modes. Each graphics mode treats the screen as a 
rectangular array of spots. Normally, your programs will use 
the features of some high-level language to draw graphics 
dots, lines, and shapes in these arrays; this section describes 
the way the resulting graphics data are stored in the Apple lies 
memory; 

5.3. 1 Low-Resolution Graphics - 

In the low-resolution graphics mode t the Apple He displays an 

array of 48 rows by 40 columns of colored blocks. Each block IL* 

can be any one of sixteen colors, including black and white. On 

a black-and-white monitor or television set, these colors appear _^ 

as black, white, and two shades of gray. There are no blank j^, 

dots between blocks; adjacent blocks of the same color merge 

to make a larger shape. 

Data for the low-resolution graphics display is stored in the 
same part of memory as the data for the 40-column text 
display. Each byte contains data for two low-resolution graphics 
blocks. The two blocks are displayed one atop the other in a 
display space the same size as a 40-column text character, 
seven dots wide by eight dots high. 

Half a byte — four bits, or one nibble — is assigned to each 
graphics block. Each nibble can have a value from to 15, and 
this value determines which one of sixteen colors appears on 
the screen. The colors and their corresponding nibble values 
are shown in Table 5-4. In each byte, the low-order nibble sets 
the color for the top block of the pair, and the high-order nibble 
sets the color for the bottom block. Thus, a byte containing the 
hexadecimal value $D8 produces a brown block atop a yellow 
block on the screen. 
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Table 5-4, Low-Resolution Graphics Colors 



Colors may vary,, depending upon 
the controls on the monitor or 

television set. 



Nibble Value 




Nibble Value 




Decimal 


Hex 


Color 


Decimal 


Hex 


Color 





SO 


Black 


B 


58 


Brown 


1 


Si 


Magenta 


9 


m 


Orange 


2 


S2 


Dark Blue 


10 


SA 


Gray 2 


3 


S3 


Purple 


1! 


SB 


Pink 


4 


$4 


Dark Green 


12 


sc 


Light Green 


b 


55 


Gray 1 


13 


$D 


Yellow 


6 


S6 


Medium Blue 


\A 


$E 


Aquamarine 


7 


$7 


Light Blue 


15 


$F 


White 



As explained in section 5.5, the text display and the 
low-resolution graphics display use the same area in memory- 
Most programs that generate text and graphics clear this part 
of memory when they change display modes, but it is possible 
to store data as text and display it as graphics, or vice versa. 
AN you have to do is change the mode switch, described in 
section 5,6, without changing the display data. This usually 
produces meaningless jumbles on the display, but some 
programs have used this technique to good advantage for 
producing complex low-resolution graphics displays quickly. 

5.3.2 High-Resolution Graphics 

In the high-resolution graphics mode, the Apple lie displays an 
array of colored dots in 192 rows and 280 columns. The colors 
available are black, white, purple, green, orange, and blue, 
although the colors of the individual dots are limited, as 
described below. Adjacent dots of the same color merge to 
form a larger colored area. 

Data for the high-resolution graphics displays is stored in 
either of two 8192-byte areas in memory. These areas are 
called high-resolution Page 1 and Page 2; think of them as 
buffers where you can put data to be displayed. Normally, your 
programs will use the features of some high-level language to 
draw graphics dots, lines, and shapes to display; this section 
describes the way the resulting graphics data are stored in the 
Apple lie's memory. 

The Apple He high-resolution graphics display is bit-mapped: 
each dot on the screen corresponds to a bit in the Apple lie's 
memory. The seven low-order bits of each display byte control 
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a row of seven adjacent dots on the screen, and forty adjacent 

bytes in memory control a row of 280 (7 times 40) dots. The — -« 

least significant bit of each byte is displayed as the leftmost dot J?^ 

in a row of seven, followed by the second-least significant bit, 

and so on, as shown in Figure 5-4. The eighth bit (the most 

significant) of each byte is not displayed; it selects one of two 

color sets, as described below. 



On a black-and-white monitor, there is a simple correspondence 
between bits in memory and dots on the screen. A dot is white 
if the bit controlling it is on (1), and the dot is black if the bit is 
off (0). On a black-and-white television set, pairs of dots blur 
together; alternating black and white dots merge to a 
continuous grey. 



U 
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On an NTSC color monitor or a color television set, a dot 

whose controlling bit is off (0) is black. If the bit is on, the dot 

will be white or a color, depending on its position, the dots on -— 

either side, and the setting of the high-order bit of the byte. Call 

the left-most column of dots column zero, and assume (for the 

moment) that the high-order bits of all the data bytes are off (0). ^^ 

if the bits that control them are on, dots in even -numbered Ir -- 

columns, 0, 2, 4, and so forth, are purple, and dots in 

odd-numbered columns are green — but only if the dots on 

either side are black. If two adjacent dots are both on, they are Sr - 

both white. 

You select the other two colors, blue and orange, by turning the m^ 

high-order bit (bit 7) of a data byte on (1). The colored dots 

controlled by a byte with the high-order bit on are either blue or 

orange: the dots in even-numbered columns are blue, and the 

dots in odd-numbered columns are orange — again, only if the 

dots on either side are black. Within each horizontal line of 

seven dots controlled by a single byte, you can have black, 

white, and one pair of colors. To change the color of any dot to 

one of the other pair of colors, you must change the high-order 

bit of its byte, which affects the colors of all seven dots p __ 

controlled by the byte. 
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In other words, high-resolution graphics displayed on a color 
monitor or television set are made up of colored dots, according 
to the following rules: 

• Dots in even columns can be black, purple, or blue. 

• Dots in odd columns can be black, green, or orange. 

• If adjacent dots in a row are both on, they are both white. 

• The colors in each row of seven dots controlled by a single 
byte are either purple and green, or blue and orange, 
depending on whether the high-order bit is off (0) or on (1). 

These rules are summarized in Table 5-5. The blacks and 
whites are numbered to remind you that the high-order bit is 
different. 

Table 5-5. High-Resolution Graphics Colors 



Colors may vary, depending on the 
adjustment of the monitor or 
television set. 



For more details about the way the 
Apple lie produces color on a TV 
set. see Chapter 1 1 . For a table of 
reversed bit patterns, refer to 
Appendix H. For information about 
the way NTSC color television 
works, see the magazine articles 
listed in the Bibliography, 



Bits 0-6 


Bit 7 Off 


Bit 7 Or 


Adjacent columns off 


Black 1 


Black 2 


Even columns on 


Purple 


Blue 


Odd columns on 


Green 


Orange 


Adjacent columns on 


White l 


White 2 



The peculiar behavior of the high-resolution colors reflects the 
way NTSC color television works. The dots that make up the 
Apple He video signal are spaced to coincide with the frequency 
of the color subcarrier used in the NTSC system. Alternating on 
and off dots at this spacing cause a color monitor or TV set to 
produce color, but two or more on dots together do not. 
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Figure 5 4. High-Resolution Display Bits 
Bits in Data Byte 











i 


2 


3 


4 


5 


6 



Dots on Graphics Screen 



5,3.3 Double-High-Resolution Graphics 

Doubie-high-resolution graphics is a bit-mapping of the 
low-order seven bits of the bytes in the two high-resolution 
graphics pages. The bytes in the main-memory and 
auxiliary-memory pages are interleaved in exactly the same 
manner as the characters in 80-column text: of each pair of 
identical addresses, the auxiliary-memory byte is displayed first. 
and the main-memory byte is displayed second. Horizontal 
resolution is 560 dots when displayed on a monochrome 
monitor. 

Unlike high-resolution color (section 5.3.2). 
double-high-resolution color has no restrictions on which colors 
can be adjacent. Color is determined by any four adjacent dots 
along a line. Think of a 4-dot-wide window moving across the 
screen: at any given time, the color displayed will correspond to 
the four-bit value from Table 5-6 that corresponds to the 
window's position {Figure 5-9). Effective horizontal resolution 
with color is 140 (560 divided by four). 

To use the table, divide the column number by 4, and use the 
remainder to find the correct column: abO is a byte residing in 
auxiliary memory corresponding to a remainder of 
(byte 0, 4. 8. and so on), mb1 is a byte residing in main memory 
corresponding to a remainder of 1 (byte 1, 2 f 9, and so on), and 
similarly for ab2 and mb3. 
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Table S-6. Doubte-High-Resotuiion Graphics Colors 



Colors may vary, depending upon 
the controls on the monitor or 
television set. 



Color 


abO 




mb1 


ab2 


mb3 


Repeated Bit 
Pattern 


Black 


$00 




SOO 


$00 


$00 


0000 


Magenta 


$08 




$11 


$22 


S44 


0001 


Brown 


$44 




S08 


$11 


S22 


0010 


Orange 


$4C 




$19 


$33 


$66 


0011 


Dark Green 


$22 




S44 


$08 


$11 


0100 


Gray 1 


$2A 




S55 


$2A 


S455 


0101 


Green 


$66 




$4C 


$19 


$33 


0110 


Yellow 


$6E 




S5D 


$3B 


$77 


0111 


Dark Blue 


$11 




$22 


$44 


$08 


1000 


Purple 


$19 




$33 


$66 


$4C 


1001 


Gray 2 


$55 




$2A 


$55 


S2A 


1010 


Pink 


$5D 




S3B 


$77 


$6E 


1011 


Medium Blue 


S33 




$66 


$4C 


$19 


1100 


Light Blue 


S3B 




$77 


$6E 


$5D 


1101 


Aquy 


$77 




$6E 


$5D 


S3B 


1110 


White 


$7F 




$7F 


$7F 


S7F 


1111 


- Unused Wt 












Momrjry 7 6 5 


* 3 2 1 C 


I ' 6 


5 4 3 


BUs in Data Byle 


4 3 2 1 


] 7 6 S 4 3 ? 1 


■ 


abD 


■ 


mbl 


■ 


ab? 


mb3 


Display | 1 


2 3|0 1 S 


3 


1 2 


3 1 D 1 2 3 


12 3 


1 1 ? 3 I 1 2 3 I 


' 


' 
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5.5 Display Pages 



Note: You cannot display 40-column text with 
double-high-resolution graphics. 

To determine what appears where in mixed-mode displays, 
refer to the upper five-sixths (down to the heavy horizontal line) 
in the appropriate graphics display (Figures 5-7 to 5-9); then 
refer to the bottom sixth of the appropriate text display 
(Figure 5-5 or 5-6). 



_ 



5 A Mixed-Mode Displays _^ 

Any of the graphics displays can have four lines of text, either 
40-column or 80-column, at the bottom of the screen. Graphics 
displays with text at the bottom are called mixed-mode 
displays. To use them, the TEXT switch must be off (read 
$C050) and the MIXED switch on {read SC053), 






The Apple lie generates its video displays using data stored in 
specific areas in memory. These areas, called display pages, 
serve as buffers where your programs can put data to be 
displayed. Each byte in a display buffer controls an object at a 
certain location on the display: a character, a colored block, or ^^ 
a group of adjacent dots, J^- - 

The 40-column-text and low-resolution-graphics modes use two 
display pages of 1024 bytes each. These are called Text Page 1 
and Text Page 2 t and they are located at $400-$7FF and 
$800-SBFF in main memory. Normally, only Page 1 is used, but 
you can put text or graphics data into Page 2 and switch 
displays instantly. Either page can be displayed as 40-column 
text, low-resolution graphics, or mixed-mode (four rows of text 
at the bottom of a graphics display). 

The 80-column text mode displays twice as much data as the 
40-column mode — 1920 bytes — but it cannot switch pages 
when the enhanced video firmware is active. The 80-column 
text display uses a combination page made up of Text Page 1 
in main memory plus another page in auxiliary memory; This 
additional memory is not the same as Text Page 2— in fact, it is 
Text Page 1X, and it occupies the same address space as Text 
Page 1 (see Figure 2-11). The built-in firmware I/O routines 






1021 Chapter 5. Video Display Output 



=5 



described in Chapter 3 take care of this extra addressing 
automatically; that is one reason to use these routines for all 
normal text output. 

Note: The built-in video firmware always displays Page 1 text. 
You cannot write text to Page 2 unless you do it yourself. 

The high-resolution graphics mode also has two display pages, 
but each page is 8192 bytes long. In the 40-column text and 
low-resolution graphics modes each byte controls a display area 
seven dots wide by eight dots high. In high-resolution graphics 
mode each byte controls an area seven dots wide by one dot 
high. Thus, a high-resolution display requires eight times as 
much data storage, as shown in Table 5-7. 

The double-high-resolution graphics mode interleaves the two 
high-resolution Pages (1 and 1X) in exactly the same way as 
80-column text mode interleaves the text pages: column and 
all subsequent even-numbered columns come from the auxiliary 
page; column 1 and all subsequent odd-numbered columns 
come from the main page. 

Table 5-7. Video Display Page Locations. (1) This is not supported by firmware; 
for instructions on how to switch pages, refer to section 5.6. (2) See 
section 5.3.3. 





Display 


Lowest Address 


Highest 


Address 


Display Mode 


Page 










40-column text, 
low-resolution 


1 

2(1) 


$400 
$800 


1024 
2048 


$7FF 
$BFF 


2047 

3071 


graphics 












80-column text 


1 
20) 


$400 
$800 


1024 
2048 


$7FF 
$BFF 


2047 

3071 


high-resolution 

graphics 


1 

2 


$2000 
S4000 


8192 
16384 


$3FFF 
$5FFF 


16383 
24575 


double-high- 
resolution 


1(2) 

2(2) 


$2000 
$4000 


8192 
16384 


S3FFF 

S5FFF 


16383 
16383 


graphics 
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5.6 Display Mode Switching 



= 

5 
j 

!j 

R7 means read the location and then check bit 1. ^ ^ 

Table 5-9 lists the display modes that the firmware can set up 

automatically. In the 40-column modes, the contents of the — ^ 

standard I/O hooks KSW and CSW (Chapter 3) determine fc^ 
whether the enhanced video firmware features are available or 

not. The firmware also takes care of setting or clearing .-^ 

ALTCHAR. t— 



Table 5-8 shows the reserved locations for the soft switches 
that control the different display modes. The left column of the 
table, labelled Action, indicates what to do to activate or read a 
switch setting. R means read the location. W means write 
anything to the location, R/W means read or write, and 



Table 5-10 lists other display modes available but not supported 
by firmware. For modes that display Page 2 with the 80COL 
switch on, your program may have to turn 80STORE off after 
the firmware has turned it on. 

Double-low-resolution shows on the display screen when HIRES 
is off and both 80COL and DHIRES are on. It Is the 
low-resolution graphics equivalent of 80-column text, and it 
uses the same map (Figure 5-6). 

The IOUDIS switch must be on for locations $C05E and $C05F 
to change DHIRES. The firmware in fact leaves it on — and your 
program should, too— unless it wants to use locations $C05E 
and $C05F to change mouse values (Chapter 9), 
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Table 5-8. Display Soft Switches. (1) The firmware normally leaves IOUDIS on. 
See also note 2. (2) Reading or writing any address in the range $C07Q-$C07F 
also triggers the paddle timer and resets VBLINT (Chapter 9). 



Action Hex Name 

W $CO0E ALTCHAR 



Function 

Off: display text using primary 
character set 



W SCOOF ALTCHAR 

R7 SC01E ROALTCHAR Read ALTCHAR switch (1 on) 



On; display text using alternate 
character set 



W SCOOC SOCOL 

W SCOOD flOCOL 

R7 SC01F RD80COL 



Off: display 40 columns 
On: display 80 columns 
Read B0COL switch (1 = on) 



W SC000 80STORE 

W 5C001 80STORE 

R7 SC018 RD80STORE Read 80STORE switch {1 = on) 



Off: cause PAGE2 on to select 
auxiliary RAM 

On: allow PAGE2 to switch main 
RAM areas 



RAW 


SC054 


PAGE2 


Off: select page 1 


R/W 


SC055 


PAGE2 


On: select page IX (80STORE 
on} or 2 


R^ 


SC01C 


RDPAGE2 


Read PAGE2 switch (1 = on) 


R/W 


SC050 


TEXT 


Off: display graphics or (if 
MIXED on) mixed 


R/W 


SC051 


TEXT 


On: display text 


R7 


SC01A 


RDTEXT 


Read TEXT switch (1 = on) 



R/W SC053 MIXED 

R/W SC054 MIXED 

R7 SC01B RDMIXED 

R/W $C057 HIRES 

R/W SC058 HIRES 



R7 



$C01D RDHIRES 



Off: display only text or only 
graphics 

On: (if TEXT off) display text and 
graphics 

Read MIXED switch (1 = on) 



Off: (if TEXT off) display 
low-resolution graphics 

On; (it TEXT off) display 
high-resolution or (If DHIRES on) 
double-high-resolution graphics 

Read HIRES switch (1 - on) 



Note 



5.6 Display Mode Switching 



105 



' 



Table 5-8— Continued. Display Soft Switches 



Action 


Hex 


Name 


Function 


w 


$C07E 


tOUDJS 


On: disable IOU access for 
addresses 5CQ58 to SC05F; 
enable access to DHIRES switch 



W SC07F IOUDIS 

R7 $C07E RDIOUDIS 

R/W $C05E DHIRES 

R/W SC05F DHIRES 

R7 $C07F RDDHIRES 



Off: enable IOU access for 
addresses SC058 to $C05F; 
disable access to DHIRES 
switch 

Read IOUDIS switch (1 = off) 



On: (if IOUDIS on) turn on 
double-high-resolution 

Off: (if IOUDIS on) turn off 
double-high-resolution 

Read DHIRES switch (1 = on) 



Note 
(i) 

(D 
(2) 



(2) 



ft- 
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Table 5-9. Display Modes Supported by Firmware (including Applesoft). (1) 80STORE is set by the firmware when 
80COL is turned on. 



Display 






Switches 














Col/Res 


Type 


Page 


80COL 


80STORE 


PAGE2 


TEXT 


MIXED 


HIRES 


DHIRES 


4Q-column 


text 




Off 




oft 


on 


off 


off 


off 


80-column 


text 




on 


d) 




on 








low-res 


graphics 




Off 




Off 


off 


off 


off 


off 


40/Iow 


mixed 




otl 




Off 


off 


on 


Off 




80/Iow 


mixed 




■[Hi 


(1) 


Off 


off 


on 


off 


off 


hi-res 


graphics 




Off 




off 


off 


off 


on 




hi-res 


graphics 


2 


ot f 




on 


off 


off 


on 




40/high 


mixed 




of 




off 


off 


on 


OH 




80/high 


mixed 




on 


(D 


off 


off 


on 


on 


off 



Table 5-10. Other Display Modes. (1) 80STORE is set by the firmware when 80COL is turned on, and must be turned off 
to use the second 80-column or double-high-resolution page. This means that you cannot use firmware routines such as 
COUT when displaying Page 2 modes not supported by firmware. 



Display 






Switches 














Col/Res 


Type 


Page 


80COL 


80STORE 


PAGE2 


TEXT 


MIXED 


HIRES 


DH 


40-column 


text 


2 


off 




on 


on 








80-column 


2 


on 


off 


on 


on 










low-res 


graphics 


2 


off 




on 


Off 


off 


off 




40/Iow 


mixed 


2 


off 




on 


off 


on 


Off 




80/Iow 


mixed 


2 


en 


off 


on 


off 


on 


off 


off 


dbl-low 


graphics 


1 


on 


(D 


off 


off 


off 


Off 


on 


dbl-low 


graphics 


2 


on 


off 


on 


OR 


off 


off 


on 


80/dbl-low 


mixed 


1 


on 


(1) 


off 


off 


on 


off 


on 


80/dbl-low 


mixed 


2 


on 


off 


on 


off 


on 


off 


on 


40/high 


mixed 


2 


off 




on 


off 


on 


on 




80/high 


mixed 


2 


on 


off 


on 


off 


on 


on 


off 


dbl-high 


graphics 


l 


on 


(1) 


off 


off 


off 


on 


on 


dbl-high 


graphics 


2 


on 


off 


on 


off 


off 


on 


on 


80/dbl-high 


mixed 


1 


on 


(1) 


off 


off 


on 


on 


on 


80/dbl-high 


mixed 


2 


on 


off 


on 


off 


on 


on 


on 
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For example, to switch to mixed 80-column and 
double-high-resolution display Page 1 t you can use these 
instructions; 



2= 



STA $C0 0D Turn on 80COL; firmware then turns on 

80STORE 

LDA SC054 Turn off PAG E2; you could also have 

done a STA 

STA $C050 Turn off TEXT; that is, turn on graphics 

mode 



STA $C053 



STA $C057 



Turn on MIXED; it works now that TEXT 
is off 

Turn on HIRES; it works now that TEXT is 
off 



- 



STA $C07E Make sure IOUDIS is on so you can 

access DHIRES 

LDA $C05E Turn on DHIRES; it works now that 



5. 7 Display Page Maps 



You should never have to store directly into display memory. 
Most high-level languages enable you to write statements that 
control the text and graphics displays. Similarly, if you are 
programming in assembly language, you should be able to use 
the display features of the built-in I/O firmware. 

A Warning 

Never caff any firmware with 80COL on or with 80S TORE and 
PAGE2 both on. tf you do, the firmware will not function 
property. As a general rule, always leave PAGE2 off. 
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The display memory maps are shown in Figures 5-5 
through 5-9. All the different display modes use the same basic 
addressing scheme: characters or graphics bytes are stored as 
rows of 40 contiguous bytes, but the rows themselves are not 
stored at locations corresponding to their locations on the 
display. Instead, the display address is transformed so that 
three rows that are eight rows apart on the display are grouped 
together and stored in the first 120 locations of each block of 
1 28 bytes (S80 hexadecimal). For a full description of the way 
the Apple He handles its display memory, refer to 
section 11.9.2. 

The high-resolution graphics display is stored in much the same 
way as text, but there are eight times as many bytes to store, 
because eight rows of dots occupy the same space on the 
display as one row of characters. The subset consisting of all 
the first rows from the groups of eight is stored in the first 
1024 bytes of the high-resolution display page. The subset 
consisting of all the second rows from the groups of eight is 
stored in the second 1024 bytes, and so on for a total of 
8 times 1024, or 8192 bytes. In other words, each block of 
1024 bytes in the high-resolution display page contains one row 
of dots out of every group of eight rows. The individual rows 
are stored in sets of three forty-byte rows, the same way as the 
text display. 

The display maps show addresses only for each Page 1. To 
obtain addresses for text or low-resolution graphics Page 2, 
add 1024 ($400); to obtain addresses for high-resolution 
Page 2. add 8192 ($2000). 

The 80-column display works a little differently. Half of the data 
is stored in the normal text Page 1 memory, and the other half 
is stored in the auxiliary memory text Page 1 . The display 
circuitry fetches bytes from these two memory areas 
simultaneously and displays them sequentially: first the byte 
from the auxiliary memory, then the byte from the main 
memory. The main memory stores the characters in the odd 
columns of the display, and the auxiliary memory stores the 
characters in the even columns (starting with column on the 
left). 

For more details about the way the To store display data in auxiliary memory, first turn on the 
displays are generated, see 80STORE soft switch by writing to location $0001 . With 

Chapter 11. 80STORE on. the page-select switch PAGE2 selects between 

the portion of the 80-column display stored in Page 1 of main 
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memory and the portion stored in the auxiliary memory. To 
select auxiliary memory, turn the PAGE2 soft switch on by 
reading or writing at location $C055, 

The double-high-resolution graphics display stores information 
in the same way as high-resolution graphics, except there is an 
auxiliary memory location as well as a main memory location 
corresponding to each address. The two sets of display 
information are interleaved in a manner similar to the 
interleaving of two 40-column displays to create an 80-column 
text display (Figure 5-9). 



Figure 5-5, Map of 40-CoIumn Text Display 
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Figure 5-6, Map of 80-Cotumn Text Display 



Row 

$400 

1 $480 

2 $500 

3 $580 

4 $600 

5 $680 

6 $700 

7 $780 

8 $428 

9 S4A8 

10 $528 

11 $5A8 

12 $628 

13 $6A8 

14 $728 

15 $7A8 

16 $450 

17 $4D0 

18 $550 

19 $5D0 



1024 
1152 
1280 
140S 
1536 
1664 
1792 
1920 
1064 
1192 
1320 
1448 
1576 
1704 
1832 
1960 
1104 
1232 
1360 
1488 



20 $650 

21 $600 

22 $750 

23 $7D0 



1616 
1744 

1872 
2000 



Main Memory 



$00 $01 $02 $03 $04 $05 
12 3 4 5 



$20 $21 $22 $23 $24 $25 $26 $27 
32 33 34 35 36 37 38 39 



$00 $01 $02 $03 $04 $05 
12 3 45 
| Auxiliary Memory p 



$06 $07/ 

6 7 



$20 $21 $22 $23 $24 $25 $26 $27 
32 33 34 35 36 37 38 39 



5.7 Display Page Maps 



Fm 



Figure S-7. Map of Low-Resolution Graphics Display 
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Figure 5-8. Map o 


Row 




$2000 


8192 


1 $2080 


8320 


2 $2100 


8448 


3 $2180 


8576 


4 $2200 


8704 


5 $2280 


8832 


6 $2300 


8960 


7 $2380 


9088 


8 $2028 


8232 


9 $20A8 


8360 


10 $2128 


8488 


11 S21A8 


8616 


12 32228 


8744 


13 S22A8 


8872 


14 $2328 


9000 


15 $23 A8 


9128 


16 $2050 


8272 


17 $20 DO 


8400 


13 $2150 


8528 


19 $2ID0 
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20 $2250 


8784 


21 $22D0 
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22 $2350 


9040 


23 323D0 


9168 
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Figure 5-9. Map of Double-H/gh-Resolution Graphics Display 



Row 

$2000 8192 

1 $2080 8320 

2 $2100 8448 

3 $2180 8576 
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6 $2300 8960 
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6 $2028 8232 
9 $20A8 8360 

10 $2128 8488 

11 $21A8 8616 

12 $2228 8744 

13 $22A8 8872 

14 $2328 9000 

15 S23A8 9128 

16 $2050 8272 

17 $20 DO 8400 

18 $2150 8528 

19 $21 DO 8656 
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5.8 Monitor Firmware Support 
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Table 5-9 summarizes the addresses and functions of the video 
display support routines the Monitor provides. Except for 
COUT and COUT1 , which are explained in Chapter 3, these 
routines are described in the subsections that follow. 

Table 8-11. Monitor Firmware Routines 



Location 
SFC9C 

$FC9E 



SFD8B 

5F819 
SFC58 



Name 
CLREOL 

CLEOLZ 



CROUT1 

HLINE 
HOME 



Description 

Clears to end of line from current 
cursor position 

Clears to end of line using 
contents of Y register as cursor 
position 



SFC42 


CLREOP 


Clears to bottom of window 


SF832 


CLRSCR 


Clears the low-resolution screen 


SF836 


CLRTOP 


Clears top 40 lines of 
low-resolution screen 


$FOED 


COUT 


Calls output routine whose address 
is stored in CSW (normally COUT1 , 
Chapter 3) 


$FDF0 


CO U I 1 


Displays a character on the screen 
(Chapter 3) 


SFD8E 


GROUT 


Generates a carriage return 
character 



Clears to end of line, then 
generates a carriage return 
character 

Draws a horizontal line of blocks 

Clears the window and puts cursor 
in upper-left corner of window 
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Table 5-11 
Location 

$F800 

SF94A 



—Continued. Monitor Firmware Routines 



Name 

PLOT 

PRBL2 



Description 

Plots a single low-resolution block 
on the screen 

Sends 1 to 256 blank spaces to 
the output device whose address is 
inCSW 



CLREOP 

CLREOP clears the text window from the cursor position to the 
bottom of the window. This routine destroys the contents of A 
and Y. 






SFDDA 


PR BYTE 


Prints a hexadecimal oyte 




SFF20 


PRERR 


Sends ERR and CONTROL-G to 

the output device whose output 
routine address is in CSW 


U- 


SFDE3 
SF941 


PRHEX 
PRTAX 


Prints 4 bits as a hexadecimal 
number 

Prints contents of A and X in 
hexadecimal 


£ 


SF871 


SCRN 


Reads color value of a 

low- resolution block on the screen 


£ 


$F864 


SETCOL 


Sets the color for plotting in 
low-resolution 




SFC24 


VTABZ 


Sets cursor vertical position 
(Setting CV at location $25 does 
not change vertical positon until a 
carriage return.) 


SF828 


VLINE 


Draws a vertical line of 
low-resolution blocks 


b= 


CLREOL 






CLREOL clears a text line from the cursor position to the right 
edge of the window. This routine destroys the contents of A 


W* 


and Y. 






£ 


CLEOLZ 






CLEOLZ clears a text line to the right edge of the window, 
starting at the location given by base address BASL indexed by 
the contents of the Y register. This routine destroys the 


gu 


contents of A and Y. 




£ 



fc- 
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CLRSCR 

CLRSCR clears the low-resolution graphics display to black. If 
you call this routine while trie video display is in text mode, it 
fills the screen with inverse-mode at-sign (@) characters. This 
routine destroys the contents of A and Y. 

CLRTOP 

CLRTOP is the same as CLRSCR, except that it clears only the 
top 40 rows of the low-resolution display. 

COUT 

COUT calls the current character output subroutine 
(section 3.3,1). The character to be sent to the output device 
should be in the accumulator. COUT calls the subroutine 
whose address is stored in CSW (locations $36 and $37). 
which is usually the standard character output COUT1 . 

court 

COUT1 (section 3.3.2) displays the character in the 
accumulator on the display screen at the current cursor 
position and advances the cursor. It places the character using 
the setting of the inverse mask (location $32). It handles these 
control characters: carriage return, line feed, backspace, and 
bell. When it returns control to the calling program, all registers 
are intact. 

CROUT 

CROUT sends a carriage return to the current output device. 

CROUT1 

CROUT1 clears the screen from the current cursor position to 
the edge of the text window, then calls CROUT. 

HLINE 

HLINE draws a horizontal line of blocks of the color set by 
SETCOL on the low-resolution graphics display. Call HLINE 
with the vertical coordinate of the line in the accumulator, the 
leftmost horizontal coordinate in the Y register, and the 
rightmost horizontal coordinate in location $2C. HLINE returns 
with A and Y scrambled and X intact. 
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HOME 

HOME clears the display and puts the cursor in the upper-left 
corner of the screen. 






PLOT 

PLOT puts a single block of the color value set by SETCOL on 
the low-resolution display screen. Call PLOT with the vertical 
coordinate of the line in the accumulator, and its horizontal 
position in the Y register. PLOT returns with the accumulator 
scrambled, but X and Y intact. 

PRBL2 

PRBL2 sends from 1 to 256 blanks to the standard output 
device. Upon entry, the X register should contain the number of 
blanks to send. If X = $00, then PRBLANK will send 
256 blanks, 

PRBYTE 

PRBYTE sends the contents of the accumulator in hexadecimal 
to the current output device. The contents of the accumulator 
are scrambled. 

PRERR 

PRERR sends the word ERR, followed by a bell character, to 
the standard output device. On return, the accumulator is 
scrambled. 

PRHEX 

PRHEX prints the lower nibble of the byte in the accumulator 
as a single hexadecimal digit. On return, the contents of the 
accumulator are scrambled. , """ 
fc- 

PRTAX 

PRTAX prints the contents of the A and X registers as a fc- 
four-digit hexadecimal value. The accumulator contains the first 

byte printed, and the X register contains the second. On return, _ 

the contents of the accumulator are scrambled. fc- 
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SCRN 

SCRN returns the color value of a single block on the 
low-resolution display. Call it with the vertical position of the 
block in the accumulator and the horizontal position in the 
Y register. The block's color is returned in the accumulator. No 
other registers are changed. 

SETCOL 

SETCOL sets the color used for plotting in low-resolution 
graphics to the value passed in the acumulator. The colors and 
their values are listed in Table 5-4. 



—J VLINE 



VLINE draws a vertical line of blocks of the color set by 
SETCOL on the low-resolution display. Call VLINE with the 
horizontal coordinate of the line in the Y register, the top 
vertical coordinate in the accumulator, and the bottom vertical 
coordinate in location $2D, VLINE returns with the accumulator 
scrambled. 
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5.9 I/O Firmware Support 



Apple He video firmware conforms to the I/O firmware protocol 
(section 3.4.2). However, it does not support windows other 
than the full 80-by-24 window in 80-column mode, and the full 
40-by-24 window in 40-colurnn mode. The video (port 3) 






Table 5-12. 


Port 3 Firmware Protocol Table 




? 


Address 


Value 


Description 


.. 


SC3QB 


$01 


Generic signature byte of firmware 
cards 


t- 


SC30C 


$38 


80-column card device signature 


y- 


SC30D 


$n 


$C3ii is entry point of initialization 
routine (P1NIT). 


SC30E 


Srr 


$C3rr is entry point of read routine 
(PREAD). 


d 


SC30F 


$WW 


$C3ww is entry point of write 
routine (PWRITE). 




SC310 


Sss 


$C3ss is entry point of the status 
routine (PSTATUS). 








£ 








& 
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PINIT 

PINIT does the following: 

• Sets a full 80-column window 

• Sets 80STORE ($C001) 



-1 
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• Sets 80COL ($C00D) 

• Switches on ALTCHAR ($C0QF) 

• Clears the screen; places cursor in upper-left corner 

• Displays the cursor. 

PREAD 



PREAD reads a character from the keyboard and places it in 
the accumulator with the high bit cleared. It also puts a zero in 
1 4 the X register to indicate IORESULT = GOOD. 



PWRITE 

PWRITE should be called after placing a character in the 
accumulator with its high bit cleared. PWRITE does the 

following: 

• Turns the cursor off. 

• If the character in the accumulator is not a control character, 
turns the high bit on for normal display or off for inverse 
display, displays it at the current cursor position, and 
advances the cursor; if at the end of a line r does carriage 
return but not line feed. See Table 5-13. 

• Carries out control functions as shown in Table 5-10. 
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G or g $07 Sounds bell (beeps) 

H or h $08 Moves cursor left one column. If 

cursor was at beginning of line, 



K or k 


$0B 


L or 1 


$0C 


Morn 


SOD 


Norn 


SOE 



J or j $0A Moves cursor down one row; 

scrolls if needed 

Clears to end of screen 

Clears screen; moves cursor to 
upper-left of screen 

Moves cursor to column 

Displays subsequent characters in 
normal video. (Characters already 
on display are unaffected.) 

O or o $0F Displays subsequent characters in 

inverse video. (Characters already 
on display are unaffected.) 

Scrolls screen up one line: clears 
bottom line 

Scrolls screen down one line; 
clears top line 

Moves cursor to upper-left (home) 
position on screen 

Clears entire line that cursor is on 

Moves cursor right one column; if 
at end of line, does CONTROL-M 

or I $1D Clears to end ofthe line the cursor 

is on. including current cursor 
position; does not move cursor 

' or 6 $1E GOTOxy; initiates a GOTOxy 

sequence; interprets the next two 
characters as x-» 32 and y-t-32, 
respectively 

$1F If not at top of screen, moves 

cursor up one line 



V or v 


$16 


W or w 


$17 


Y or y 


519 


Z or z 


S1A 


or \ 


$1C 



- 



Table 5-13. Pascal Video Control Functions 

CONTROL- Hex Function performed ^ ■ 

^- 
E or e S05 Turns cursor on (enables cursor 

display) 

F or f SOB Turns cursor off (disables cursor 

display) 



_ 



moves it to end of previous line — 



fe- 
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When PWR1TE has completed this, it 

• turns the cursor back on (if it was not intentionally turned 
off). 

• puts a zero in the X register (10 RESULT = GOOD) and 
returns to the calling program. 

PSTATUS 

A program that calls PSTATUS must first put a request code in 
the accumulator: either a (meaning "Ready for output?' 1 or a 1 
(meaning "Is there any input?"), PSTATUS returns with the reply 
in the carry bit: (No) or 1 ( Yes). If the request was not or 1 , 
PSTATUS returns with a 3 in the X register 
(IORESULT = ILLEGAL OPERATION); otherwise, PSTATUS 
returns with a in the X register (IORESULT = GOOD). 
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The external disk drive connector 
is described in section 11.10. 



o 

PI 



CD 



The Apple He supports both its built-in disk drive and an 
optional external drive; both drives use single-sided, 35-track, 
16-sector format. The disk I/O port characteristics are 
summarized in Table 6-1. 

The firmware resides in the SC600 address space. It supports 
the built-in drive as if it were slot 6 drive 1, and the external 
drive as if it were slot 6 drive 2, If disk startup is unsuccessful, 
the firmware shuts off the disk drive motor and displays the 
message, Check Disk Drive on the display screen. 

Table 5- 1 . Disk I/O Characteristics 



Port Number 


I/O Port 6 Drive 1 (built-in drive) 
I/O Port 6 Drive 2 (external drive) 


Commands 


IN #6 or PR #6 

CALL -151 (to get to the Monitor 




from BASIC), then (F) ( control Kk) or 

(T}(C0MTHOtHP) 


initial 
Characteristics 


All resets except t control Hheset) 

with a valid reset vector e\ 

pass control to the built-in disk drive. 


Hardware Location 


Description 


SCOEQ-EF 


Reserved 


Monitor Firmware 

Routines 


None 


I/O Firmware Entry 
Points 


SC600 (port 6) 


Use or Screen Holes 


Port 6 mam and auxiliary memory 



screen holes are reserved. 
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& 1 Startup 



A power-on startup, an j~&) - j control X"rIset") startup, or a 
(cqntrqlK reset] startup that does not find a valid reset vector 
results in a cold start. The cold-start routine first sets a number 
of soft switches (see Chapter 2) and then passes control to the 
program entry point at $C600. This code turns on the internal 
drive motor, recalibrates the read/write head at track zero, then 
reads sector zero from that track. The sector contents are 
loaded and decoded starting at address $800; then program 
control passes to $801 . This loaded program varies depending 
on the operating system or application program on the disk. 

To restart the system, issue a PR*6 command from BASIC, 
(J) ( control K p from Monitor command mode, or 
JMP $C600 from a machine-language program. 



6.2 External Drive Startup 



The ProDOS operating system (but not the DOS or Pascal 
operating systems) supports startup using the external disk 
drive. This ProDOS feature makes it possible to start the 
Apple lie with a diagnostic program in the event that the built-in 
drive does not work. 

To restart using the external drive, insert a ProDOS disk in the 
external drive, then invoke the Monitor (CALL -151) and issue 
CD ( controlX F). 

Remember: External drive startup works with ProDOS-based 
programs, but not with Pascal 1.1 or 1.0, or with DOS. 
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If you need to change port 
characteristfcs from a program. 
read section 7.6 for the methods to 
use. 



=3 



if you change port 1 to a 
communication port, refer to the 
descriptions in Chapter 8, and 
use 1 instead of 2 for the port 
number when required. 



Serial port 1 is the first of two serial I/O ports available on the 
Apple lie. It is intended primarily as an output port for RS-232 
devices, such as printers and plotters. It can be changed to a 
serial communication port (like port 2) using the System Utilities 
Disk. 

Warning 

Although the Apple He serial ports are similar to the Apple He 
Super Serial Card, there are many important differences. Refer 
to Appendix F for a summary of these differences. 

Table 7-1 summarizes the characteristics of this port if used as 
a printer/plotter port, and is a guide to the other information in 
this chapter. 

The serial port back panel connectors are described in 
section 11.11. 



-14 



I 

■ 

I 



=5 



Chapter 7: Serial I/O Port 1 



129 



Table 7-1. Serial Port 1 Characteristics 

Port Number 

Commands 






Initial Characteristics 
Hardware Page Locations 
Monitor Firmware Routines 
I/O Firmware Entry Points 
Use of Screen Holes 
Use ot Other Pages 



Serial port 1 

Keyboard command 
PR#1 

BASIC command 
PR#1 

Monitor command 

1 CONTROL-P (does not work 
if there is an operating system 
in RAM) 

All other commands 
Table 7-2 

Table 7-3 

Table 7-4 

None 

Table 7-5 
Table 7-6 
None 



7, 1 Using Serial Port 1 



Refer to Table 7-5 for the standard 
firmware entry points that 
Pascal t.1 and 1.2 use. 



You can access the firmware from BASIC in the usual way— 
that is, by issuing CONTROL-D (if DOS or ProDOS is in RAM) 
and PR#1. Subsequent output is directed to the printer (or 
other device) connected to serial port 1 . 

To direct Pascal output to the printer, you can use either #6: 
or PRINTER: . 

Table 7-2 lists the commands you can use with serial port 1 , 
either from a program or from the keyboard, after you issue 
PR#1. Each command must be preceded by CONTROL-I (the 
command character). As soon as you issue the command 
character, the serial port firmware displays a flashing question 
mark cursor to indicate it is awaiting a command. 

You do not have to press ( return) after commands. 

Note: The commands themselves are letter commands, not 
control characters. 



: 
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Table 7-2. Printer Port Commands 

Command Description 

nnn Set new line width of nnn (from 1 through 255), This command 

must be followed by N (see below} or by a carnage return. 

nnB Set baud rate to value corresponding to nn: 



nD 



nn 


Rate 


nn 


Rate 


1 


50 


9 


1800 


? 


75 


10 


2400 


3 


110 (109.92) 


11 


3600 


4 


135 (134.58) 


12 


4800 


5 


150 


13 


7200 


6 


300 


14 


9600 


7 


600 


Id 


19200 


•3 


1200 






Set data format to values corresponding to n: 




n 


Data Bits 


Stop 


Bits 





a 


1 




1 


7 


1 




2 


6 


i 




3 


5 


i 




4 


8 


2 




5 


7 


2 




6 

7 


B 

I 


2 
2 





I Echo printer output on the screen. 

K Disable automatic line feed after carriage return. 

L Generate line feed after carriage return. 

nnnN Change line width to nnn {from 1 through 255; nnn is optional); do 

not echo printer output on the screen. Note: ON does not disable 
automatic generation of carriage return; to do so, use Z command, 
put directly <n location S579 or use System Utilities Disk. 
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Table 7-2— Continued. Printer Port Commands 
Command Description 

nP Set parity corresponding to n: 

n Parity 

None 

1 Odd 

2 None 

3 Even 

4 None 

5 MARK(1) 

6 None 

7 SPACE (0) 

R Resel port 1 (Table 7-3) and exit from serial port 1 firmware. 

S Send a 233 millisecond BREAK character (used with some printers 

to synchronize with serial ports). 

Z Zap (ignore) further command characters (until fcpN TBOLK reset) or 

PRrtM). Do not format output or insert carriage returns into output 
stream. 

The command character starts off as CONTROLS for the printer 
port. You can change it to a different control character by 
typing the current control character followed immediately by the 
new control character you want. This is useful if you want to be 
able to send CONTROL-I to the printer without firmware 
intervention. For example, to change the command character 
from CONTROL-I to CONTROL-V, simply press ( control tf j) 
( control H v). (CONTROL- V and CONTROL-W are the 
recommended substitute control characters,) To change the 
command character back again, press (control H P 
( cqntrolX T). 

Do not use ( control K aI. -(F). -(c), -©, -GD> <D. -® or -© 
Apple lie firmware may intercept these control characters, 
causing unpredictable results. 
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The following are examples of valid commands and command 
sequences. 

Echo output to the display screen: 

C CONTROL X T) CD 

Set line width 72, disable line feed, and echo: 
[control H P HO ( controlK T) (zXDGD 
Change control character to CONTROL-V: 

[CONTROL H P (CONTROlX T) (RETURN) 

An example of how you can send CONTROL-I as part of a 
character stream: 



( control"H "v1 (command) (return) 



7.2 Characteristics at Startup 



After power-up, the printer firmware sets the configuration given 
in Table 7-3. These values are stored in the auxiliary-memory 
screen holes (Table 7-6). 

Table 7-3. Initial Characteristics of Printer Port 

9600 baud 

Eight data bits, no parity bits, two stop bits 

80-column line width; no echo to display screen 

Firmware supplies line feed after carnage return. 

Command character is set to CONTROL-I (see below). 

You can change some of these settings from the keyboard by 
typing PR#1, the command character, and one of the 
commands listed in Table 7-2. Section 7.6 describes how port 
characteristics change as a result of various activities. 

Note: You can type more than one command on a line, but 
each must be preceded by the command character. 
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73 Hardware Page Locations 



ACIA stands for Asynchronous 
Communication Interface Adapter, 

a serial I/O chip. Note in 
Chapter 1 1 that some of the bit 
assignments for this port differ 
from those for port 2, 



Table 7-4 lists for serial port 1 the addresses and bit 
assignments of its hardware registers on page SCO. The 
registers are internal to a 6551 ACIA; their bit assignments are 
described in section 11.11. 

Table 7-4. Serial Port l Hardware Page Locations 



Location 


Description 


$C090-$C097 


Reserved 


SCQ98 


ACIA transmit/receive data register 


SC099 


ACIA status register 


SC09A 


ACIA command register 


SC09B 


ACIA control register 


SC09C-SC09F 


Reserved 



7 A I/O Firmware Support 



Table 7-5 lists the locations and values of the I/O firmware 
protocol table. This standardized protocol is available for use 
by any application program. Section 3.4.2 describes how to use 
this protocol. 

Table T-5. Port 1 I/O Firmware Protocol 



Address 


Value 


Description 


SC105 


S38 


Pascal ID byte 


SC107 


S18 


Pascal ID byte 


SC10B 


$01 


Generic signature byte of firmware 
cards 


SC10C 


$31 


Same ID as for Super Serial Card 


SC10D 


Sii 


$C1ii is entry point of initialization 
routine (P1NIT). 



SC1DE 



SC10F 



SC110 



sent 



Sww 



Sss 



non-0 



$C1rr is entry point of read routine 
(PREAD). 

$C1ww >s entry point of write 
routine (PWRITE). 

SC1ss is entry point of the status 

routine (PSTATUS). 

No optional routines 



6= 

.Ml 
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7.5 Screen Hole Locations 



in Chapter 11. 



Table 7-6 lists the screen hole locations that serial port 1 uses. 
I h ® A c l A r ??' ster bits are defir,ed Note that the auxiliary-memory locations are reserved for 

startup value settings, which are listed and interpreted in the 
table. 

Table 7-6. Serial Port 1 Screen Hole Locations 

Auxiliary Memory Screen Holes (firmware loads at power-up reset): 



Location 


Description 




$478 


$9E (AC I A control reg: 6 data + 2 stop bits. 9600 baud) 


$479 


SOB (ACIA command reg: no parity) 


$4 7 A 


$40 (flags: no echo, auto LF after CR, serial port) 




Bit 


Interpretation 




7 


Echo output on display (0 ■ no echo) 




5 


Generate LF after CR (0 = no LF) 




5-1 


Always = (reserved) 







1 - communication port; = serial printer 
port 


$47B 


$50 (printer width: 30 columns) 




Bit 


Interpretation 




7-0 


Printer width {0 = do not insert CR) 


Main Memory Screen Holes: 




Location 


Description 




$479 


Reserved 




$4F9 


Reserved 




$579 


Printer width (1 - 255; - disable formatting) 


$5F9 


Temporary storage location 


$679 


Bit 7 = 1 while the firmware is parsing a command string. 


$6F9 


Current command character (initially CONTROL-I) 


$779 


Bit 7 = 1 if echo to display is on; bit 6 = 1 if firmware is 
to generate a line feed after carriage return. 


S7F9 


Current printer column 



T .5 Screen Hole Locations 1 35 



7.6 Changing Port Characteristics 



j 



i 



Figure 7-1 is a diagram of where the port characteristics are 
stored and moved under different circumstances. As you can 
see from the figure: 

• When the power is first turned on, the Monitor reset 
firmware moves the predefined set of port characteristics 
listed in Table 7-3 from ROM into the auxiliary memory 
screen holes listed in Table 7-6. 

• If you specify new characteristics using the System Utilities 
Disk, the SUD software changes the values in the auxiliary 
memory screen holes. 

• The values stored in the auxiliary memory screen holes are 
affected by power-on reset, but not by either 
fgT H controUX reset ) or a simple ( control H reset) . This 
feature is provided so that a port that has been 
reconfigured will remain that way while some other program 
(such as an application program) is started up. 

• PR#1 causes the firmware to move the characteristics 
stored in the auxiliary memory screen holes into the main 
memory screen holes. 

• A program can change values in the main memory screen 
holes directly. However, the only value guaranteed to be in 
the same place for the entire Apple I! series is the line 
length in main memory location $579. 

• The firmware uses the port as it is defined in the main 
memory screen holes at any given time. You should use the 
commands listed in Table 7-2 to change them. 
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Figure 7-1. Port Characteristics 



System Utilities Disk 

PIN Number Selection 

(See Appendix H) 




Port 1 

Values in 

Firmware Locations 

(See Table 7-3 



Port 1 

Auxiliary RAM 
Screen Holes 

See Table 7-6) 



Printer Port 

Commands 

(See Table 7-2) 





Port 1 

Main RAM 

Screen Holes 

(See Table 7-6) 

Reserved Screen Holes 
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7.6. 1 Data Format and Baud Rate 

Serial data transfer consists of a string of ones and zeros sent 
down a wire at a prearranged rate of speed, called the baud 
rate With most equipment, baud simply equals the number of 
bits per second. 

Before transfer begins, both sender and receiver fook for a 
continuous value of 1: this is called the carrier (Figure 7-2), 
When the value goes to zero, the receiver presumes it is a start 
bit— that is, the bit that designates the beginning of a character 
of data. If it lasts longer than a bit could possibly last, it is 
considered a BREAK signal, which some printers use for 
synchronization. 

If the first zero proves to be a bit, it is interpreted as the start 
bit. Next come the 7 or 8 data bits (6 is seldom used with 
computers), low-order bit first. If parity is on, it comes next in 
the message. Finally, one or two stop bits (with a value of 1) 
appear. The stop bits have a value of 1 , like the carrier The 
next start bit begins transfer of the next character of data. 
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The parity bit provides a simple check of data validity. Odd 
parity means the sender counts the number of ones among the 
data bits, and sends the appropriate parity bit to make the total 
number of ones odd. With even parity, the sender adds the 
appropriate parity bit to make the total number of one-bits even. 
MARK parity is always a 1 bit; SPACE parity is always a zero. 
The receiver can then check that the parity bit is correct. 

If the baud rate is 300, and the data format is 1 start bit plus 
7 data bits plus 1 parity bit plus 1 stop bit, then the actual 
transfer rate is about 30 characters per second. 

Figure 7-2. Data Format 



J~L 

i_r 



1 or MARK f 7 

1 Start + | 
= or SPACE I 8 





f N ° I 

Odd 


. 


■ Data + \ 


Even 
MARK 


- Parity 4 I 




SPACE 





Stop 



= 



=— 



U-- 



1- 

0- 



LSB 



::~lr 



Start 
Bit 





I 



MSB 





Car tier 



1 t 

Odd Stop 

Parity Sit 



Next 

Start 



ASCII letter M = $40; sent as 8 data, odd parity, 1 stop bit. 



7.6.2 Carriage Return and Line Feed 

If you are using a typewriter and you push the carriage all the 
way to the right (in other words, position the printing 
mechanism at the left margin), you have performed a carriage 
return. On the other hand, turning the platen so the paper 
moves to the next line (or using the index key on an electric 
typewriter) is called a line feed. Most typewriters perform a line 
feed automatically after a carriage return, and so the two seem 
to be one — but they are not. 

Carriage return and line feed are separate ASCII codes. 
Carriage return is sometimes denoted CR; it is ASCII 
code 13 ($0D). Line feed, sometimes denoted LF, is ASCII 
code 10 ($0A). (T) on the Apple He keyboard generates a LF. 
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Some printers can supply a line feed automatically after 
detecting a carriage return; others cannot. If the printer does 
not supply a line feed after a carriage return and it is not 
supplied in the data stream, the printer will keep printing over 
on the same line. On the other hand, if both the printer and the 
Apple lie firmware supply LF after CR, double line-spacing will 
result. 

If the print head keeps moving too far to the right across the 
page and then prints many characters on top of one another on 
the right, then the firmware should be instructed to furnish CR 
after a certain line width has been reached. It the printer prints 
too short a line before moving to the next line, then probably 
the firmware is using too small a line width. 

If the printer misses characters at the beginning of each line but 
otherwise prints correctly, there is probably not enough time for 
the print mechanism to return to the left margin in response to 
CR. You must use a lower baud rate with such a printer. 

7.6.3 Sending Special Characters 

If you want to send special characters (control characters) to 
the printer without having them intercepted and executed by the 
Apple lie firmware, use the Z command. If the only special 
character that causes a problem is the command character 
(normally CONTROL! for port 1), you can change just the 
command character instead of using the zap (Z) command. If 
you use the zap command, the firmware does no formatting; 
that is, it does not check line width or insert carriage returns or 
fine feeds, This may be necessary to send graphics to a printer 
or plotter, 

7.6.4 Displaying Output on the Screen 

You can display printer output on the screen, but if the printer 
line width exceeds the 40 or 80 columns you have selected for 
display, you should turn off video display. 
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Serial port 2 is the second of two serial I/O ports available on 
the Apple lie. It is intended primarily as a communication port 
for modems. You can change it to a serial printer port (like 
port 1) using the System Utilities Disk. If you need to change 
port characteristics from a program, read section 8.6. 

Warning 

Although the Apple He serial ports are similar to the Apple 
Super Serial Card, there are many important differences. Refer 
to Appendix F for a summary of these differences- 
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If you change port 2 to a serial 
printer port, refer to the 
descriptions in Chapter 7. and 

use 2 instead of 1 for the port 
number when required. 



Table 8-1 summarizes the characteristics of this port and is a 
guide to the other information in this chapter. 

The serial port connectors are described in section 11.11. 

Table 8-1. Serial Port 2 Characteristics 



Port Number 
Commands 



Serial Port 2 

Keyboard commands 

1N#2 before TabJe 8-2 

commands 

IN#2 to accept port 2 input 
PR#1 to echo input to printer 
PR #2 to echo input back to 
port 2 

BASIC commands 
(same) 

Monitor command 

® f control X F) (This command 
works only if there is no 
operating system in RAM.) 





All other commands 




Table 8-2 


Initial Characteristics 


Table 8-3 


Hardware Page Locations 


Table 8-4 


Monitor Firmware Routines 


None 


I/O Firmware Entry Points 


Table 8-5 


Use of Screen Holes 


Table 8-6 


Use of Other Pages 


In terminal mode, fir 



auxiliary memory locations S800-$87F 
to store keyboard input, and 
$880-$8FF as a serial input buffer. 
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S. 1 lte//7gr Serial Port 2 



Refer to Table 8-5 for the standard 
firmware entry points that 
Pascal 1.1 and 1.2 use. 



^3 



You can access the firmware from BASIC in the usual way — 
that is, by issuing CONTROL-D (if DOS or ProDOS is in RAM) 
followed by IN #2 or PR#2. Subsequent input and output are 
routed through the modem (or other device) connected to serial 
port 2. 

Note: In terminal mode, the modem port commands listed in 
Table 8-2 must follow CONTROL-D and IN#2 {not PR#2) 
and the command character (which is usually CONTROL-A). 

To transfer files to the modem under Pascal, specify REMOUT: 
or #8: . To transfer files from the modem under Pascal, specify 
REMIN: or #7: , 

Table 8-2 lists the commands you can use with serial port 2, 
either from a program or from the keyboard, after you issue 
IN#2. Each command must be preceded by CONTROL-A (the 
command character). As soon as you issue the command 
character, the serial port firmware displays a flashing question 
mark cursor to indicate it is awaiting a command. If you press 
( return ) , you get the current video cursor again, 

You do not have to press ( return ) after commands. 

Note: The commands themselves are letter commands, not 
control characters. 
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Table 8-2. Modem Port Commands 
Command Description 

ninn 



nnB 



nD 



Set new line width of nnn (from 1 through 255); this must be 
followed immediately by N (see below) or by carriage return. 

Set baud rate to value corresponding to nn; 

nn Rate nn 

1 50 9 

2 75 10 

3 110(109.92) 11 

4 135(134.58) 12 

5 150 13 

6 300 14 

7 600 15 

8 1200 
Set data format to values corresponding to n: 



1 8C0 
2400 
3600 
480C 

7200 

9600 
19200 



Data Bits 

B 
7 
6 
5 
3 
7 

e 

5 



Stop Bits 

1 
1 
1 
1 
2 

2 
2 
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Table 8-2— Continued. Modem Port Commands 
Command Description 

I Echo output on the screen. 

K Disable automatic line feed after carriage return. 

L Generate line feed after carriage return. 

nnrtN Set line width to nnn (from 1 through 255); do not echo output on 

the screen, Note: ON does not turn off automatic generation of 
carriage return; to do so, use 2 command, put directly in 
location $57A, or use the System Utilities Disk, 

nP Set parity corresponding to n: 



n 


Parity 






Q 


None 






1 


Odd 






2 


None 






3 


Even 






A 


None 






5 


MARK (1) 






B 


None 






7 


SPACE (0) 






Quit terminal mode, 






Reset port 2 (Table 8-3) and exit from serial 


port 


2 firmware. 


Send 


a 233 millisecond BREAK character. 







Q 



T Enter terminal mode. Use this command after 1N#2 only. Also, if 

you follow this command by PR#2, the Apple lie will echo input to 
output. {If the other device does so too, the first character entered 
will loop endlessly, locking up the system, Use t control H reset] to 
get out,) 

Z Zap (ignore) further command characters until ( control H beset j . Do 

not format output or insert carriage returns into output stream. 

( control H T) This command from a remote device puts the Apple lie in terminal 
mode if IN #2 is already in effect. It is the same as ( control H P CD 
typed locally. 

Cco NTROLH rpThis command from a remote device undoes the terminal mode 
command. If IN#2 and PR#2 are in effect, the remote keyboard 
and display become the input and output devices of the local 
Apple lie. It is the same as ( control H a] (q) typed locally. 
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The command character starts off as CONTROL-A for the 
communication port. You can change it to a different control 
character by typing the current control character followed 
immediately by the new control character you want. This is 
useful if you want to be able to send CONTROL-A to the output 
device without firmware intervention. 

For example, to change the command character from 
CONTROL-A to CONTROL-V, simply press ( control H P 
( control H v). (CONTROL-V and CONTROL-W are the 
recommended substitute control characters.) To change the 
command character back again, press ( controlV TvI 
( control> (a). 

Warning 

Do not use ( control ) -Cb), -(c), -(h), {T), <j), -{70, <mT) or {V): 
Apple lie firmware may intercept these control characters, 
causing unpredictable results. 

The following are examples of valid commands and command 
sequences. 

Enable echo to the screen: 

CcontrqlXa) 03 

Send a BREAK character to a remote device: 

( control H ~a) (b) 

Change the control character to CONTROL-V (For example, so 
you can send CONTROL-A as part of a character stream.): 

( control H 7Q ( control M V) ( control > fv) (command) 
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8.2 Characteristics at Startup 



3 

ha 



After power-up, the firmware sets the configuration given in 
Table 8-3, These values are stored in the auxiliary-memory 
screen holes (Table 8-6). 

Table 8-3, Initial Characteristics of Communication Port 

300 baud 

Eight data bits, no parity bits, one stop bit 

Firmware does not supply line feed after carriage return. 

Firmware does not insert carriage returns into output stream. 

Firmware does not echo output to the display screen. 

Command character Is set to CONTROL-A. 

You can change some of these settings from the keyboard 
using the command character followed by one of the commands 
listed in Table 8-2, Section 8,6 describes how port 
characteristics change as a result of various activities. 

If you change any of these values using keyboard commands or 
commands from a program, subsequent accesses to the port 
firmware (even by another program) use the new settings 
instead of the power-up values. This allows you to change the 
settings once at system startup, and get the desired 
configuration for subsequent uses. Refer to section 8,6 for a 
complete description of these processes. 
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8,3 Hardware Page Locations 



ACIA stands for Asynchronous 
Communication Interface Adapter, 
a serial I/O chip. Note in 
Chapter 1 1 that some of the bit 
assignments for this port differ 
from those for port 1 . 



Table 8-4 lists for serial Port 2 the addresses of its hardware 

registers on page $C0. The registers are internal to a 

6551 ACIA; their bit assignments are described in section 11.11. 

Table 8-4, Serial Port 2 Hardware Page Locations 



Location 


Description 


SC0A0-SC0A7 


Reserved 


$C0A8 


ACIA transmit/receive data register 


SC0A9 


ACIA status register 


$C0AA 


ACIA command register 


$C0AB 


ACIA control register 


$C0AC-SC0AF 


Reserved 






8.4 I/O Firmware Support 



Table 8-5 lists the values in the I/O firmware protocol table for 
serial port 2, This standardized protocol is available for use by 
any application program. Section 3.4,2 describes how to use 
this protocol. 

Table 8-5. Port 2 I/O Firmware Protocol 



Address 


Value 


Description 


SC205 


$38 


Pascal ID byte 


SC207 


$18 


Pascal ID byle 


SC20B 


$01 


Generic signature byte of firmware 
cards 


SC20C 


$31 


Same ID as for Super Serial Card 


SC20D 


$ii 


SCI ti is entry point of initialization 
routine (PINIT). 


SC20E 


$rr 


SClrr is entry point of read routine 
(PREAD). 


SC20F 


$ww 


$C1ww is entry point of write 
routine (PWRITE). 


SC210 


Sss 


$C1ss is entry point of the status 
routine (PSTATUS). 


SC211 


non-0 


No optional routines 



a- 



..i - 
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8.5 Screen Hole Locations 



The AG A register bits are defined 
in Chapter 11. 



Table 8-6 lists the screen hole locations that serial port 2 uses. 
Note that the auxiliary-memory locations are reserved for 
startup value settings, which are listed and interpreted in the 
table 

Table 8-6. Serial Port 2 Screen Hole Locations 

Location Description 

Auxiliary Memory Screen Holes {firmware loads values at power-up}; 



S47C 


$16 (ACl A control rec 


j: 8 data + 1 stop bit, 300 baud) 


S47D 


SOB (ACIA command 


reg; no parity) 


S47E 


$01 (flags: no echo, no auto LF after CR, communication port) 




Bit 


Interpretation 




7 


Echo output on display (0 = no echo) 




6 


Generate LF after CR (0 = no LF) 




5-1 


Always = (reserved) 




D 


1 D communication port; = serial printer 
port 



$47F $00 (line length: do not add any CR to output stream) 

Bit Interpretation 

7-0 Line length (0 = do not insert CR) 

Main Memory Screen Holes: 

£4 7 A Reserved 

$4FA Reserved 

$57A Line length (1 - 255; disable formatting) 

$5FA Temporary storage location 

$67A Bit 7 = 1 ft and only if the firmware is currently parsing a 

command string. 

£6i ■'- Current command character (initially CONTROL-!) 

$77 A Bit 7 1 if echo to display is on; bit 6 = 1 if firmware is to 

generate a line feed after carriage return. 

57FA Current column 



=a 
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8.6 Changing Port Characteristics 



j 
3 

Figure 8-1 is a diagram of where the port characteristics are | 

stored and moved under different circumstances. As you can 
see from the figure: 



When the power is first turned on t the Monitor reset 
firmware moves the predefined set of port characteristics 
fisted in Table 8-2 from ROM into the auxiliary memory 
screen holes listed in Table 8-6. 



"j 

"J 

LL-J 

~j 

UL i 






If you specify new characteristics using the System Utilities 
Disk, the utility software changes the values in the auxiliary 
memory screen holes. 

The values stored in the auxiliary memory screen holes are 
affected by power-on reset, but not by either 
(HT H contrqlH reset ] or a simple C control H reset ) . This 
feature is provided so that a port that has been 
reconfigured will remain that way while some other program 
(such as an application program) is started up. 

IN #2 causes the firmware to move the characteristics 

stored in the auxiliary memory screen holes into the main 

memory screen holes. M- - 

A program can change values in the main memory screen 
holes directly. However, the only value guaranteed to be in -^ 

the same place for the entire Apple II series is the line ti 

length in main memory location $57A. 

The firmware uses the port as it is defined in the main ^i .., 

memory screen holes at any given time. You should use the 
commands listed in Table 8-2 to change these 
characteristics. 
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Figure 8-1. Port 2 Characteristics 



Port 2 

Values in 

Firmware Locations 

See Table 8-3) 



System Utilities Disk 

PIN Number Selection 

(See Appendix H) 





Port 2 
Auxiliary RAM 
Screen Holes 

(See Table 8-6) 



Communication Port 

Commands 

(See Table 8-2) 





Port 2 

Main RAM 

Screen Holes 

(See Table 8-6) 

Reserved Screen Holes 



8.6. 1 Data Format and Baud Rate 

Section 7,6.1 describes data format and baud rate, and 
explains how they apply to printers. Refer to that section or to 
the Glossary for the definition of terms. 

A noteworthy characteristic of data communication is its 
strangeness: sometimes the oddest changes make a given 
communication arrangment work or not work. You must keep 
this notion firmly in mind when working with serial port 2. For 
example, modem communication involves quite a few elements 
(Figure 8-2): 

• the Apple tic and its firmware, with the baud rate, data 
format, and other characteristics you have selected 

• the cable from the Apple lie to the modem 

• the modem 

• possibly an acoustic coupler for a telephone handset 
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• the telephone lines, with their switching equipment, boosters, 
and noise 

• some combination of modem, cable, and computer or 
terminal on the other end. 



Figure 8-2. Devices in a Typical Communication Setup 




Local DTE 

(Data Terminal 
Equipment) 



Local DCE 

{Data Communication 

Equipment) 



Transmission Line 



Remote DCE 



Hemote die 
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As you can imagine, some method is required for success. If 
you have problems, change only one variable at a time, and 
then cycle through the other variables one at a time. Take 
nothing for granted. The data format advertised for an 
information service, for example, may be different from the one 
you end up using with the Apple lie. 

8.6,2 Carriage Return and Line Feed 

If you are communicating with a computer or terminal, carnage 
return and line feed may or may not be involved. Start off 
without generating them, and turn on automatic generation only 
as needed. They are described as used with printers in 
section 7.6.2. 
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8.6.3 Routing Input and Output 



This section discusses the possible ways that serial port 2 can 
route information. Sometimes the cause of communication 

^^ problems is that information is not going where you think it is. 

-^4 or it is and you cannot see evidence of the fact. Figures 8-3 

through 8-6 show some of the patterns of information flow you 

— . can select. This section and the following subsections telf you 

—-4 how to use them. 

It is best to read all of this material as a unit: questions that 
arise white you read one description may be answered 
"■^3 elsewhere. 

3 
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Figure 8-3. Effect of !N#2 
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For a further description of what 
terminal mode does and how to 
get into and out of it refer to the 
last section of this chapter. 
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The simplest serial port 2 command is IN#2 (Figure 8-3). 
Port 2 becomes the input device. Data coming into the port 
gets passed to the input buffer (page 2 of main memory). 
Applesoft firmware and system software can see the data and 
carry out commands in the normal way. 

Of course, you can also use just the PR#2 command — for 
example, if you want to send a listing to the modem. 

To use port 2 for data communication, you ordinarily put it into 
terminal mode. Following IN #2, typing { control H "a") gets the 
attention of the port 2 firmware, which displays a blinking 
question mark (?) as a prompt Now type (T) to put the 
computer in terminal mode. In this mode, the firmware displays 
a blinking underscore character (_) as a prompt. 

In the discussion that follows, local refers to your Apple lie. 
Remote refers to some other device, usually in a distant 
location and at the other end of a communication link. The 
remote device can be any ASCII-generating unit: a terminal or a 

computer. 
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ff a remote computer is another Apple He or an Apple II series 
machine with a Super Serial Card in it, then most of the 
commands described here apply to it as well. 



Half Duplex Operation 

In half-duplex operation, information can flow from A to B or 
from B to A, but in only one direction at a time. In a half-duplex 
setup, the host does not echo back to the terminal what the 
terminal sends it For half-duplex operation, use IN#2 and 
C control > Ca) (t) (Figure 8-4) whether the Apple lie is the host 
or the terminal. 



Figure 8-4. Effect of !N#2 and T Command (Half Duplex) 




-a r£ 



\ 



Printer "* 



=3 

=3 



. Communication 
Device 



■#- 



Remote 

Communication 
Device 



|(PR#1) 



_D 



vid 



Port 1 

FW 






I 



i —J Port 2 I 

^ H FW 



MON « * 



Remote 

Terminal 
or Computer 



Keyboard 



IN #2 plus ( control K aI (T) is the best way to set up the 
computer for auto-answer operation. The T command allows 
port 2 firmware to exchange information with the local modem 
without interference from the local firmware or system 
software. (The remote device can always cancel the 
T command with c control K rI if necessary, and restore 
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terminal mode with ( control H T).) Avoiding PR#2 at this point 
means that the Apple lie can operate as a half-duplex terminal, 
half-duplex host, or full-duplex terminal. (The remote device 
can also issue ( control H P PR#2 if PR#2 is required at the 

focal computer.) 



Figure 8-5 shows the flow of information when the Apple lie is a 
full-duplex terminal. (The setup commands, IN #2 and 
(control H a") (T), are the same as for half duplex.) 

If your Apple lie is the terminal in full-duplex operation, use the 
N command to turn off echoing input to the screen. If the 
Apple He does echo input to the screen in this setup, everything 
you type will appear twice: once from the Apple lie and once 
from the host computer. 



e- 



*— 



In half-duplex operation, the output hook is available for other 
uses. For example, you can issue PR#1 to print incoming _ - 

messages from port 2. Use the ( cqntrql >(~a] (T) command to U— 

display information on the screen. 

Full Duplex Operation Jj^ - 

In full-duplex operation, information can flow from A to B and 
from B to A simultaneously. Typically, one of the computers (the 
host computer) echoes its input to output, so the other —- 

computer (the terminal) can easily verify that the communication 
is taking place. 



4±- 



In this mode of operation, if you echo input to the printer you 

can get a printed record of both sides of the communication __ - 

session: the input from the host, and the Apple lie output as 

echoed by the host. 
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Figure 8-5. Effect of IN#2 and T Command (Full Duplex Terminal) 
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Figure 8-6 shows the flow of information when the Apple lie is 
a full-duplex host In this case, the local Apple lie must echo 
input to output for the remote device. The setup commands 
include PR#2 in this case. 
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Warning 

If the Apple He echoes input to output and the other computer 
does too, then the first subsequent keypress will echo back and 
forth endlessly and lock up the Apple He, This will require a 
( control H reset) to get out. 

if you echo input to output when using an information service, 
the host will end up seeing the echo of what it sent you as 
though you had typed it. 

In this arrangement, the local output hook is not available for 
using the printer or other device. To display keyboard and 
port 2 input on the screen, issue ( control H P (T). 



Figure 8-6. Effect of IN #2, PR #2 and T Command (Full Duplex Host) 
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Terminal Mode 

Terminal mode makes the Apple Uc act like a dumb terminal- 
one that just sends and receives information, but does not 
process it Input and output flow through special serial I/O 
buffers on page 8 of auxiliary memory. Applesoft firmware and 
system software cannot see or interpret the data: only the serial 
port 2 firmware deals with it. 

In most terminal mode setups, the firmware will not display 
port 2 input unless you use the ( control H a) (T) command. 



Warning 

When using terminal mode, $800-$8FF of auxiliary RAM is used 
for buffering. Any data stored there will be overwritten when 
terminal mode is enabled. 



( control K aI (T) turns on terminal mode, and ( control H a) (q) 
turns it off. 

The remote device can go into terminal mode, and then turn off 
the local Apple lie's terminal mode with the (control}-® 
command. If it then issues ( control H "a) PR#2 f local output will 
go to the remote device. The remote keyboard and display then 
become the input and output devices of the local Apple Ifc 
processor. This is remote mode. 

In remote mode, the local Apple lie does not use the serial I/O 
buffers {as it does in terminal mode); therefore, local firmware 
and system software detect and interpret all input and output 
data. So, for example, if you type CATALOG at the remote 
device keyboard, the local Apple lie will execute the command 
and list the disk catalog on the remote devices display. (In 
terminal mode, the local computer would simply display the 
word CATALOG on its screen.) 

The remote device can turn the local Apple He's terminal mode 
back on with ( control H T). ( control H a) (T) typed at the 
remote device only turns on the remote device's terminal mode, 
unless the command character there has already been changed 
to something else. 
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CD 
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Section 9.1,6 gives an example of 
how to use the mouse as a hand 

control. 



This chapter describes the mouse port and hand control (game) 
input capabilities of the Apple lie. The mouse and hand controls 
use the same 9-pin connector on the back panel; the firmware 
uses the port as directed by keyboard or program commands. 

A program can tell if a hand control is connected (section 9.2) 
but not if a mouse is connected, unless the computer user 
moves it. 



I 



| 
=3 



Chapter 9: Mouse and Game Input 



1161 



ft 1 Mouse Input 



Table 9-1 is a summary of the characteristics of the mouse port 
and a guide to the other information in this part of the chapter. 

Warning 

If you want to ensure compatibility with mouse operation on the 
Apple He and other Apple II series computers, always use the 
I/O firmware entry points fisted in Tables 9-4 and 9-5, rather 
than dealing with mouse hardware and RAM locations directly. 

The mouse back panel connector is described in section 11.12. 

Table 9-1. Mouse Input Port Characteristics 

Port Number Mouse Input Port 4 



BASIC commands 



initial Characteristics 

Hardware Page Locations 
Monitor Firmware Routines 
I/O Firmware Entry Points 
Use of Screen Holes 



Turn on mouse: 

PRINT CHRftC4> >l PR#4":PRINT 

CHRtCD 

Turn off mouse interrupts: 
PRINT' I PR* , 4 ,, :PRINT CHRtCOl 
Turn on graphics character set: see 
section 5.2,2, 

After a reset, all mouse interrupts are 
off. and the rising edge of XO and YO 
are selected for interrupts. 

Table 9-2 

None 

Table 9-3 and Table 9-4 

Table 9-5 



9. 1. 1 Mouse Connector Signals 

The mouse uses the same 9-pin D-type miniature connector as 
the hand controls. However, the interpretation of the signals 
arriving on the pins differs depending on the commands and 
signals received. The names of the pin assignments when a 
mouse is connected are shown in Figure 11-37. 
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Section 5.2.2 contains 
recommendations for using 
MouseText characters with 
mouse. 



9. 1.2 Mouse Operating Modes 

Later sections of this chapter describe how to set various 
modes for mouse operation. This section tells what the modes 
are for. 

In all the interrupt modes — that is, all but transparent mode — 
the user program should call the SERVEMOUSE routine to 
determine the source of an interrupt as soon as it receives one. 

Transparent Mode 

In this mode, a program must read screen holes to check for 
mouse movement. In reality, however, an interrupt routine in the 
Apple He firmware updates mouse position counters each time 
the mouse is moved, then returns control to the main program 
task 

This is the only mouse mode available to BASIC programs. 

Movement interrupt Mode 

On the Apple He, a signal called VBLINT can interrupt the 
processor whenever a video vertical blanking signal occurs. 
This provides for efficient program coordination of the mouse 
cursor with mouse movement. 

In movement interrupt mode, the mouse firmware arms VBLINT 
whenever the mouse is moved at least one count in any 
direction. When VBLINT occurs, program control passes to the 
vector address contained at locations $3FE and $3FF; the 
interrupt handler can then update the cursor smoothly to its 
next screen position. 

The receiving interrupt handler must first call SERVEMOUSE 
(Table 9-3) to see if the mouse caused the interrupt. It should 
then call READMOUSE to get mouse status and its current 
X-Y position. The routine can also change the mouse mode and 
position if desired. 

The maximum amount of mouse movement that can occur 
between successive VBLINT interrupts is limited only by the 
distance someone can move a mouse in one sixtieth of a 
second. 
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Button interrupt Mode 

The Apple lie mouse-button hardware location does not 
generate interrupts. However, a program can simulate 
mouse-button interrupts by polling the button whenever VBLINT 
occurs, and acting on the interrupt whenever the button state B^ 

has changed. This alleviates the program overhead required to 
poll the button constantly to provide fast response. 

Movement/Button Interrupt Mode 

This is a combination of the two modes just described. It 
provides the best response possible without constant polling of 
the mouse position and button. Processing of a main task can 
be concurrent with cursor and menu updating, as well as 
menu-selected command processing. 

Vertical Blanking Active Modes fc - 

These modes are the same as the four just described except 
that they allow VBLINT interrupts to be sent to the user. 



£ 



9. 1.3 Mouse Hardware Page Locations 

The soft switches assigned to the mouse interface are shown in 
Table 9-2. On power-up or reset, the hardware selects the 
rising edge of XO and YO and masks out all mouse interrupts. 

Mouse firmware sets interrupts in response to mode settings 
under program control. The vertical blanking interrupt (VBLINT) 
is armed if the mouse button is pushed or there is a change of 
at least a count of 1 in the XO or YQ coordinate. Since VBL 
occurs every sixtieth of a second, at most that amount of time 
will elapse before the resulting interrupt can be acknowledged 
and acted upon. To reset the VBL interrupt, read $C070. 

Software can also select which edge of XO and YO information f^Z 
will cause the XI NT or YINT. 

Once an interrupt has occurred, you can read the mouse's 

X1 and Y1 direction in data-bus bit 7 by reading address 5C066 

and SC067, respectively. 

A program can read the status of the soft switches by reading 
one of the locations $C040-$CQ43 and then testing data bit 7. 

Section 11.12 explains what XO, YO, X1, Y1 are and what they 
mean with respect to mouse movement. 
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A Warning 

Table 9-2 is included here for your information; however you 
Appendix e explains how the should use the built-in firmware to access the mouse. If you do 

firmware handles interrupts, write your own mouse interrupt handler, it should enable the 

main bank-switched memory, set up its own IRQ vectors at 
addresses $FFFE and $FFFF, keep track of video modes and 
the alternate stack, and check for the interrupt source in the 
same manner as the mouse firmware listed in Volume 2 of this 
manual. 

Using the built-in firmware is much easier and guarantees 
compatibility with all other Apple II series computers. 
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Table 9-2. Mouse Hardware Page Locations. (1) When lOUDtS is on, 
$C058-$C05F do not affect mouse, and $C05E and $C05F become DHIRES 
(Table 5-8). (2) Read or write to $CO?x also resets VBLINT and triggers paddle 
timers. (3) These work only if IOUDIS is off. (4) This location is also the (OJ key 
(Table 4-1). (5) This is also the location of the shift-key mod (Appendix F). 



Action 
W 

W 



R/W 



Hex 

SC07E 



Name 

IOUDIS 



SC07F IOUDIS 



Function Notes 

On: disable IOU access for (1 1 

addresses $C058 to SC05F; 
enable access to DHIRES switch 

Off: enable IOU access for (1) 

addresses $C058 to SC05F; 












disable access to DHIRES 
switch 




- 


R7 


$C07E 


RD10UDIS 


Read IOUDIS switch (1 - off) 


m 


l -i - 


R/W 


$C058 


DISXY 


Disable (mask) XO and YO 
movement interrupts 


m 


R/W 


$0059 


ENBXY 


Enable (allow) XO and YO 
movement interrupts 


(3) 


~ 


R7 


$C040 


RDXYMSK 


Read status of XO/YO interrupt 
mask (1 = mask on) 




far 


R 


SC048 


RSTXY 


Reset XO/YO interrupt Hags 




R/W 


SC05C 


XOEDGE 


Select rising edge of XO for 

interrupt 


(3) 




R/W 


SC05D 


XOEDGE 


Select falling edge of XO for 
interrupt 


(3) 


e 


R7 


$C042 


RDXOEDGE 


Read status of XO edge selector 
(1 = falling) 




H 


$C015 


RSTXINT 


Reset mouse XO interrupt flag 




u* 


R/W 


SC05E 


YOEDGE 


Select rising edge of YO for 

interrupt 


(3) 




R/W 


$C05F 


YOEDGE 


Select falling edge of YO for 
interrupt 


(3) 


±— ' 


R7 


SC043 


RDYOEDGE 


Read status of YO edge selector 
(1 = falling) 




u- 


R 


SC017 


RSTYINT 


Reset mouse YO interrupt flag 






R/W 


SC05A 


D1SVBL 


Disable (mask) VBL interrupts 


i3) 


UJ 


R/W 


$C05B 


ENVBL 


Enable (allow) VBL interrupts 


(3) 




R7 


$C041 


RDVBLMSK 


Read status of VBL interrupt 




^ 



$00 19 RSTVBL 



$C070 PTRIG 



mask (1 = mask on) 

Read and then reset VBLINT 



Reset VBLINT flag; trigger 
paddle timer 
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Table 9-2 — Continued. Mouse Hardware Page Locations 



Action 


Hex 


Name 


Function 


Notes 


R7 


SC061 


RDBTNO 


Read hand control button status 
(1 = pressed) 


(43 


R7 


SC063 


RD63 


Read mouse button status 
(0 = pressed) 


(5) 


R7 


$C066 


MOUX1 


Read status of X1 (mouse 
X direction) (1 - high) 




R7 


$C067 


MOUY1 


Read status of Y1 (mouse 
Y direction) (1 = high) 





9. 1.4 I/O Firmware Support 

The Apple lie supports the mouse with firmware starting at 
address $C400. This firmware is necessary because the mouse 
requires fast, transparent interrupt processing to work 
effectively. 

In assembly language, which you might need to use for 
sophisticated mouse applications, you can use direct firmware 
support. To enable the mouse, first load a mode byte into the 
accumulator (and $C4 in X, $40 in Y), and then do a JSR to the 
firmware routine called SETMOUSE (Table 9-3). Valid mode 
bytes are; 



S01 
$03 
$05 
$07 
$08 
$09 
SOB 
$0D 
$0F 



Turn mouse off 

Set transparent mode 

Set movement-interrupt mode 

Set button -interrupt mode 

Set movement- or button-interrupt mode 

Turn mouse off, VBLINT active 

Set transparent mode, VBLINT active 

Set movement-interrupt mode, VBLINT active 

Set button -interrupt mode, VBLINT active 

Set movement- or button-interrupt mode, VBLINT active 



The firmware will then initialize the mouse. To read the current 
position and status of the mouse, first load $C4 into the 
X register, load $40 into the Y register, save processor status, 
disable interrupts, and then JSR to the firmware routine called 
READMOUSE (Table 9-3), which stores the information in the 
port 4 screen holes (Table 9-5). 

Table 9-3 lists the mouse port firmware routine offsets. Each 
address contains the low byte of the entry point of the routine 
described. The calling setup for all routines (except 
SERVEMOUSE) is the same: the X register must contain $C4, 
and the Y register must contain $40. When the routine has 
finished, the A, X. and Y register contents are undefined. 



.1 Mouse Input 



1167 



J 



Table 9-3. Mouse Firmware Routines 
Location Offset For 

$C412 SETMOUSE 



$C413 



SERVEMOUSE 



READMOUSE 



$C415 



CLEARMOUSE 



$C416 



SC417 



POSMOUSE 



CLAMPMOUSE 



SC418 



HOMEMOUSE 



Description 

Sets the mouse mode to the value 

in the accumulator 

Input: A register contains mode 

(see $7FO Table 9-5), 

Output: Carry bit means mode 

was legal: carry bit - 1 means 

mode was not legal. 

Services mouse interrupt if needed 

Input: X, Y, A registers — doesn't 

matter 

Output: Carry bit = means 

mouse caused the interrupt; carry 

bit = 1 means something else 

caused it. 

This routine updates S77C to show 

which event caused the interrupt 

(values in Table 9-5). 

Updates screen holes to show 
current mouse X-Y position and 
button status; clears VBLINT, 
button and movement interrupt bits 
in the status byte. Don't re-enable 
interrupts until after retrieving 
position values. 
Output: Carry bit - 

Sets the mouse position to 0, 

though not necessarily within 

clamping boundaries; leaves button 

and interrupt bits in status byte 

unchanged. 

Output: Carry bit - 

Sets the mouse coordinates to new 

values. 

Input: X and Y screen holes 

contain new X and Y positions. 

Output: Carry bit = 

Sets new clamping boundaries (see 
Table 9-5). Does not affect mouse 
position or update mouse position 
screen holes; use READMOUSE to 
do that 

Input: A register = means set 
new X boundaries; A register = 1 
means set new Y boundaries. 
Output: Carry bit = 

Sets the internal mouse position to 
the upper-left corner of the 
clamping window. Does not update 
mouse position screen holes; use 
READMOUSE to do that. 



L*4 



4— i 
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Table 9-3 — Continued. Mouse Firmware Routines 

SC419 INITMOUSE Sets startup internal values; does 

not update mouse- position screen 
holes. 
Output: Carry bit = 

Here is a sample sequence of events and calls. 

1. Four screen holes contain the mouse' s X and Y coordinates, 
and one contains the status of the last mouse movement 
{Table 9-5). 

2. Call INITMOUSE. 

3. Inhibit interrupts, set up the boundaries you want, then call 
CLAMPMOUSE. 

4. Use POSMOUSE, HOMEMOUSE or CLEARMOUSE to 
position the mouse where you want it. 

5. Put the mode (see address $7FC in Table 9-5) in the 
accumulator, then call SETMOUSE. 

6. If you have set one of the interrupt modes, then when an 
interrupt arrives, call SERVEMOUSE to determine the source 
of the interrupt. 

7. Disable interrupts and call READMOUSE, Retrieve the 
position values, then re-enable interrupts. 
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Pascal Support 

Table 9-4 lists the locations and values of the I/O firmware 
protocol that Pascal 1.1 and 1.2 use. However, Pascal must use 
a special attach driver to support the mouse. 

Table 9-4. Mouse Port I/O Firmware Protocol 



3 



Address 


Value 


Description 




SC405 


S38 


Pascal ID byte 


SC407 


S18 


Pascal ID byte 


J 


SC40B 
SC40C 


101 

S20 


Generic signature byte of firmware 
cards 

2 X-Y pointing device; 
— identification code 


-a. 


$C40D 




Initialization routine (not 
implemented; returns error code) 


$C40E 




Standard read routine (not 
implemented; returns error code) 


$C40F 




Standard write routine (not 
implemented; returns error code) 


_u- 


$C410 




Standard status routine (not 
implemented; returns error code) 


L** 


$C411 


$00 


Optional routines follow. 


- 


SC4FB 


$D6 


A mouse identification byte 


^ 



1 

: 
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BASIC and Assembly-Language Support 

In BASIC, before you can get input from the mouse, you must 
turn it on by printing PR#4 and then CHR$(1). This sets 
transparent mode. After that re-enable video output with PR #3, 
and take subsequent input from the mouse by issuing !N#4. 
The first input statement after that (INPUT X,Y,S) initializes and 
enables the mouse, and returns a three-element string: 

+ xxxx 1 + yyyy, + st 

representing the x-coordinate, y-coordinate and status digits. 

The coordinates will be integers between and +1023. These 
are called the clamping boundaries of the mouse. 

The sign preceding the status digits is normally positive; it 
becomes negative when you press a key on the keyboard. 

The first digit, s, of the status is 0. The second digit, t, of the 
status is 1 if the mouse button is still pressed, 2 if it was just 
pressed, 3 if it was just released, and 4 if it is still released. 

To disable the mouse: 



PRINT CHR$C4V*PR#4" 
PRINT CHR$C0> 
PRINT CHRC4> ,i PR*3 ,, 

9. 1.5 Screen Holes 

Table 9-5 lists the screen holes that the mouse firmware uses. 
Note that the mouse firmware reserves port 5 screen holes for 
its own use. Also, the auxiliary-page counterparts of the port 4 
addresses are reserved for startup values. 



Note: Some screen holes are different for the Apple lie 
mouse. Refer to Appendix F. 
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Table 9-5. Mouse Peripheral Card RAM Locations 

Scratch Area: 
Location Description 



1721 



5478 


Low byte 


of clamping minimum 




$4F8 


Low byte 


of clamping maximum 




$578 


High byte 


of clamping mimirnum 


$5F8 


High byte 


of clamping maximum 


Port 4 Screen Holes: 






Location 

$47C 


Description 

Low byte of X coordinate 




$4FC 


Low byte 


of Y coordinate 


- 


$57C 


High byte 


of X coordinate 




$5FC 


High byte of Y coordinate 


* 


$67C 


Reserved 




£ 


S6FC 


Reserved 






$77C 


Status byl 


e 




e.t 


1 Equals 


1 




/ 


Button down 


& 




6 


Button was down on last read and still 
down. 


\ 




5 


Movement since last read 


J!f 




4 


Reserved 






3 


Interrupt from VBLINT 


£ 




2 


Interrupt from button 


" 




1 



Interrupt from movement 
Reserved 


MM 


$7FC 


Mode byte {current mode; mask out bits 4-7 when testing) 
Bit 1 Equals 




7-4 


Reserved 


-- 




3 


VBLINT active 


Ud 

- 




2 


VBLINT interrupt on button 


A 




1 


VBLINT interrupt on movement 


— 







Mouse active 


u 


Port 5 Screen Holes: 




£ 






Reserved 


^ 
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9. 1*6 Using the Mouse as a Hand Control 

This section describes how to use the mouse as if it were a set 
of hand controls, or an X-Y pointing device in port 4. !f you 
turn the mouse on, the Monitor hand-control (game paddle) 
routines will take input from the mouse. This is possible 
because the mouse and the hand controls all use the same 
back-panel connector. 

You can run a BASIC program that uses the PDL function to 

read from the mouse by doing this: 

1. Start up the system with the BASIC program that uses 
paddles. 



2. Type PR '4 and press (return J to turn on the mouse. 

3. Press f control H X) ( return ) to initialize the mouse. 



4. Type PR*0 and press ( return ) to restore output to the 
screen. 

5, RUN the program 

Play the game using the mouse instead of the paddles. 

Note: Many copy-protected games will not work with a 
mouse. Also, many games don't use built-in firmware for the 
paddles. 
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9.2 Game Input 



Complete electrical specifications 
of these inputs are given in 
Chapter 11; Table 11-22 shows the 
connector pin numbers. 



The Apple He supports game paddles, joysticks, and other hand 
controls connected to the DB-9 connector on its back panel. 
Table 9-6 is a summary of game input characteristics. 

Table 9-6, Game Input Characteristics 



Port Number 


None 


Commands 


None 


Initial 
Characteristics 


Game inputs cannot be disabled. 


Hardware Page 
Locations 


Description 


SC061 


Switch input and (6 ) 


SC062 


Switch input 1 and I * I 


SC063 


Mouse button. (Sense is opposite thai 
distinguish it from paddle button) 


SC064 


Analog input (paddle) 


SC065 


Analog input (paddle) 1 


$C070 


Trigger paddle timer 


Monitor 
Firmware 

Routines 


Name Description 


$FB1E 


PREAD Read a paddle position 


I/O Firmware 
Entry Points 


None 


Use of Screen 
Holes 


None 



9.2. 1 The Hand Control Connector Signals 

Several inputs are available on a 9-pin D-type miniature 
connector on the back of the Apple lie: two one-bit inputs, or 
switches, and two analog inputs. You can access all of these 
signals from your programs. 

When you connect a pair of hand controls to the 9-pin 
connector, the rotary controls use two analog inputs, and the 
push-buttons use two one-bit inputs. However, you can also 
use these inputs for many other jobs. For example, two analog 
inputs can be used with a two-axis joystick. 



J 

1 

:- 

urn 

I— 

\ 

LLi 

J- 
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Switch Inputs (SWO and SW1) 

The two one-bit inputs can be connected to the output of 
another electronic device that meets the electrical requirements 
(Chapter 11), or to a pushbutton. When you read a byte from 
one of these locations, only the high-order bit — bit 7 — is valid 
information; the rest of the byte is undefined. From machine 
language, you can do a Branch Plus or Branch Minus on the 
state of bit 7. From BASIC, you read the switch with a PEEK 
and compare the value with 128. If the value is 128 or greater, 
the switch is on. 

The memory locations for these switches are $C061 , SC062 and 
$C063, as shown in Table 9-6, Switch and switch 1 are 
permanently connected to Qfp and (X) on the keyboard; these 
are the ones connected to the buttons on the hand controls. 
Location $C063 is a second address for the mouse button, so 
that a program can distinguish it from an (j5J keypress. When 
the mouse button is pressed, $C063 (Bit 7) goes from 1 to 0, 
and $C061 (Bit 7) goes from to 1. When the mouse button is 
pressed, $C063 (Bit 7) goes from 1 to 0. 



9.2 Game Input 



1175 



Analog Inputs (POLO and PDL 1) 

The two analog inputs are designed for use with 150K ohm 
variable resistors or potentiometers. The variable resistance is 
connected between the + 5V supply and each input, so that it 
makes up part of a timing circuit (refer to section 11.13 for 
details). The circuit changes state when its time constant has 
elapsed, and the time constant varies as the resistance varies. 
Your program can measure this time by counting in a loop until 
the circuit changes state, or times out. 

Before a program can read the analog inputs, it must first reset 
the timing circuits. Accessing memory location SC070 does this. 
As soon as you reset the timing circuits, the high bits of the 
bytes at locations SC064 through $C067 are set to one. If you 
PEEK at them from BASIC, the values will be 128 or greater. 
Within about 3 milliseconds, these bits will change back to 
zero — byte values less than 128— and remain there until you 
reset the timing circuits again. The exact time each of the bits 
remains high is directly proportional to the resistance connected 
to the corresponding input. If these inputs are open — no 
resistances are connected — the corresponding bits may remain 
high indefinitely. 






u— 



J- 
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You can read and reread the same 
paddle at arbitrarily short intervals. 
However* you must wait at least 
3 milliseconds between reading 
one paddle and reading a different 
lie. 



■a 
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9.2.2 Monitor Support 

To read the analog inputs from machine language, you can use 
a program loop that resets the timers and then increments a 
counter until the bit at the appropriate memory location changes 
to zero, or you can use the built-in routine PREAD. BASIC and 
other high-level languages also include convenient means of 
reading the analog inputs — refer to your language manuals. 

PREAD 

The Monitor routine PREAD (at address $FB1E) places in the 
Y register a number between $00 and $FF that represents the 
position of a hand control. You pass the number of the hand 
control in the X register. 

Warning 

If the hand control number you furnish in the X register does 

not equal or 1, strange things may happen. 



Warning 

The paddle and vertical blanking both use $C070. If you are 
reading the paddles and using VBL interrupts, disable interrupts 
before calling PREAD. 



=a 
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The System Monitor is a set of subroutines in the Apple lie 
firmware. The Monitor provides a standard interface to the 
built-in I/O devices described in Chapter 1 . Many of the I/O 
subroutines described in Chapters 3 through 9 are part of the 
System Monitor. 

DOS (but not ProDOS) and the BASIC interpreters (Appendix E) 
use these subroutines by direct calls to their starting locations. 
The starting addresses for all of the standard subroutines are 
listed in Appendix C, If you wish, you can call the standard 
subroutines from your programs in the same fashion. 

You can perform most of the Monitor functions directly from the 
keyboard. This chapter tells you how to use the Monitor 

• to look at one or more memory locations 

• to change the contents of any location 

• to write programs in machine language to be executed 
directly by the Apple lies microprocessor 

• to move and compare blocks of memory 

• to invoke other programs from the Monitor. 

•^_ I 10.1 Invoking the Monitor 

The positive and negative decimal The System Monitor starts at memory location $FF69 (-151). To 
^__ equivalents of Monrtor locations invoke the Monitor, you make a CALL statement to this location 

"■y addition^App^endtx H*contains from the keyboard or from a BASIC program. When the Monitor 

conversion tables from one is running, its prompting character, an asterisk (*), appears on 

^^_ numbering system to another. tne j e ft S \$ B f tne display screen, followed by a cursor. 
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Each command you type consists of one command character, 
usually the first letter of the command name. The Monitor 
recognizes 22 different command characters. Some of them are 
punctuation marks, some are letters (uppercase or lowercase), 
and some are control characters. 
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To use the Monitor, you type commands at the keyboard. When 
you have finished using the Monitor, you return to the BASIC 
language you were previously using by pressing 
(controlK reset) , by pressing ( contrqlH cI and then ( return ] , 
or by typing 3D0G, which executes the resident program — 
usually Applesoft — whose address is stored in a jump 
instruction at location S3D0. 

Note: If DOS or ProDOS is connected via the standard I/O 
links (Chapter 3), then you can issue commands to it from 
the Monitor. Under this arrangement, errors will return 
control to BASIC rather than to the Monitor. 

If you want to have { control K reset ) return you to the Monitor, 
load the values $69, $FR and $5A into the three locations 
starting at address $3F2 (the reset-vector address and the 
power-up byte). 



1 0.2 Syntax of Monitor Commands 

To give a command to the Monitor, you type a line on the ^ 

keyboard, then press (return) . The Monitor accepts the line 

using the standard I/O subroutine GETLN described in 

Chapter 3. A Monitor command can be up to 255 characters in ^ 

length, ending with a carriage return. U^ 

A Monitor command can include three kinds of information: 
addresses, data values, and command characters. You type 
addresses and data values in hexadecimal notation. 



if- 



When the command you type calls for an address, the Monitor ^ 

accepts any group of hexadecimal digits. If there are fewer than 

four digits in the group, it adds leading zeros; if there are more 

than four hexadecimal digits, the Monitor uses only the last four ^ 

digits. It follows a similar procedure when the command syntax 

calls for two-digit data values. 



j 

d 
d 

1 



—4 

^5 



Note: Although the Monitor recognizes and interprets them, 
control characters typed on an input line do not appear on 
the screen. 

This chapter contains many examples of the use of Monitor 
commands. Some of the data values displayed by your Apple He 
may differ from the values printed in these examples, because 
they are variables stored in programmable memory. 



i 
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When you use the Monitor to examine and change the contents 
of memory, it keeps track of the address of the last location 
whose value you inquired about and the address of the location 
that is next to have its value changed. These are called the last 
opened location and the next changeable location. 

Warning 

Because locations $C0O0 through $COFF contain special 

hardware circuits, issuing any command that reads or writes on 

this page can have unpredictable, and perhaps disastrous, 

results 



10.3. 1 Examining Memory Contents 

When you type the address of a memory location and press 
(return) , the Monitor responds with the address you typed, a 
dash, a space, and the value stored at that location, like this: 



*EQ00 



-y E000- 4C 

•33 

"^ 0033- AA 



Each time the Monitor displays the value stored at a location, it 
saves that address as the last opened location and as the next 
changeable location. 



I 
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10.3.2 Memory Dump 

When you type a period {.) followed by an address, and then 
press ( return l , the Monitor displays a memory dump: the data 
values stored at all the memory locations from the one following 
the last opened location to the location whose address you 
typed following the period. The Monitor saves the last location 
displayed as both the last opened location and the next 
changeable location. In these examples, the amount of data 
displayed by the Monitor depends on how much larger the 
address after the period is than the last opened location. 



3 



( 20 



0020- 


00 




* . 2B 






0021- 


28 


00 18 OF 


0028- 


A8 


06 DO 07 


*3QC 






0300- 


99 




♦.315 







0C 00 



0301- B9 00 08 0A QA 0A 99 
0308- 00 08 C8 DO F4 A6 2B A9 
0310- 09 85 27 AD CC 03 
•.32A 

0316- 85 41 

0318- 84 40 8A 4A 4A 4A 4A 09 

0320- CO 85 3F A9 5D 85 3E 20 

0328- 43 03 20 

* 

When the Monitor performs a memory dump, it starts at the 
location immediately following the last opened location and 
displays that address and the data value stored there. It then 
displays the values of successive locations up to and including 
the location whose address you typed, but only up to eight 
values on a line. When it reaches a location whose address is a 
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multiple of eight— that is, one that ends with an 8 or a — it 
displays that address as the beginning of a new line, then 
continues displaying more values. 

After the Monitor has displayed the value at the location whose 
address you specified in the command, it stops the memory 
dump and sets that location as both the last opened location 
and the next changeable location. If the address specified on 
the input line is less than the address of the last opened 
location, the Monitor displays only the address and value of the 
location following the last opened location. 

You can combine the two commands, opening a location and 
dumping memory, by simply concatenating them: type the first 
address, a period, and the second address. This combination of 
two addresses separated by a period is called a memory range. 

•300. 32F 

0300- 99 B9 00 08 0A 0A 0A 99 
0308- 00 06 C8 DO F4 A6 2B A9 
0310- 09 85 27 AD CC 03 85 41 
0318- 84 40 8A 4A 4A 4A 4A 09 
0320- CO 85 3F A9 5D 85 3E 20 
0328- 43 03 20 46 03 A5 3D 4D 
•30.40 

0030- AA 00 FF AA 05 C2 05 C2 
0038- IB FD DO 03 3C 00 40 00 
0040- 30 
*E015.EQ25 

E015- 4C ED FD 

E018- A9 20 C5 24 B0 0C A9 8D 

E020- A0 07 20 ED FD A3 



^5 



Pressing (return) by itself causes the Monitor to display one 
line of a memory dump; that is, a memory dump from the 
location following the last opened location to the next 
multiple-of-eight boundary. The Monitor saves the address of 
the last location displayed as both the last opened location and 
the next changeable location. 
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*s 

OOOB- 00 

♦ (return) 


* C RETURN ) 



0008- 00 00 00 Ql 
•32 



00 00 00 00 



032- F F 
* f return! 

AA 00 C2 05 C2 

* ( RETURN ) 

0038- 1B FD DO 03 3C 00 3F 00 



10.3.3 Changing Memory Contents 

Section 10.3,2 showed you how to display values stored in the 
Apple lie's memory; this section shows you how to change 
these values. You can change any location in RAM; you can 
change the characteristics and treatment of an output device by 
changing the contents of locations assigned to it; and you can 
change a soft switch setting by referencing its set and reset 
addresses. 

Warning 

Use these commands carefully. If you change the zero-page 

locations used by the interpreter or operating system 

(Appendix B), you may lose programs or data stored in 

memory. 



-j 



Changing One Byte 

The previous commands keep track of the next changeable 
location; these commands make use of it. In the next example, 
you open location 0, then type a colon followed by a value. 
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*•** 



*0 



0000- 4C 
•:5F 



The contents of the next changeable location have just been 
changed to the value you typed, as you can see by examining 
that location: 



*0 



0000- 5F 

« 

You can also combine opening and changing into one operation 
by typing an address followed by a colon and a value. In the 
example, you type the address again to verify the change. 

*302;42 

•302 

0302- 42 

* 

When you change the contents of a location, the value that was 
contained in that location is replaced by the new value, which 
will remain until you replace it with another value. 

Changing Consecutive Locations 

You don't have to type a separate command with an address, a 
colon, a value, and press ( return ) for each location you want to 
change. You can change the the values of up to eighty-five 
consecutive locations at a time — or even more, if you omit 
leading zeros from the values — by typing only the initial address 
and colon followed by all the values separated by spaces; end 
with (return) . The Monitor will store the consecutive values in 
consecutive locations, starting at the location whose address 
you typed. After it has processed the string of values, it takes 
the location following the last changed location as the next 
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changeable location. Thus, you can continue changing 
consecutive locations, without typing an address on the next 
input line, by typing another colon and more values. In these 
examples, you first change some locations, then examine them 
to verify the changes, 

•300:69 01 20 ED FD 4C 3 

•300 

0300- 69 
' (return) 

01 20 ED FD 4C 00 03 
*10:0 1 2 3 

*:4 5 6 7 

*1Q. 17 

0010- 00 01 02 03 04 05 06 07 

* 

10.3.4 Moving Data in Memory 



£2 






You can copy a block of data stored in a range of memory 
locations from one area in memory to another by using the 
Monitors MOVE command. To move a range of memory, you 
must tell the Monitor both where the data is now situated in 
memory — the source locations — and where you want the copy 
to go — the destination locations. You give this information to 
the Monitor by means of three addresses: the address of the 
first location in the destination and the addresses of the first 
and last locations in the source. You specify the starting and 
ending addresses of the source range by separating them with 
a period. You separate the destination address from the range 
addresses with a less-than character (<), which you may think 
of as an arrow pointing in the direction of the move. Finally, you 
tell the Monitor that this is a MOVE command by pressing (W) . 
The format of the complete MOVE command looks like this; 

] destination; < start: . ]end| (W) 
Chapter 10: Using the Monitor 
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When you type the actual command, replace the words in 
braces with hexadecimal addresses, and omit the braces and 
spaces. Here are some examples of memory moves. First, you 
examine the values stored in one range of memory, then store 
several values in another range of memory. The actual MOVE 
commands end with Cm) . 

*0.F 

0000- 5F 00 05 07 00 00 00 00 

0008- 00 00 00 00 00 00 00 00 

•300 :A9 8D 20 ED FD A9 45 20 DA FD 4C 00 

03 

•300. 30C 

0300- A9 8D 20 ED FD A9 45 20 
0308- DA FD 4C 00 03 
*0<3Q0.30C® 

*0.C 

0000- A9 8D 20 ED FD A9 45 20 
0008- DA FD 4C 00 03 
*310<8.ACm3 

♦310.312 

0310- DA FD 4C 
*2<7.9(m3 

*0.C 

0000- A9 8D 20 DA FD A9 45 20 

0008- DA FD 4C 00 03 

« 

The Monitor moves a copy of the data stored in the source 
range of locations to the destination locations. The values in the 
source range are left undisturbed. The Monitor remembers the 
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last location in the source range as the last opened location, 
and the first location in the source range as the next 
changeable location. If the second address in the source range 
specification is less than the first, then only one value (that of 
the first location in the range) will be moved. 

See section 10.6 for an interesting If the destination address of the MOVE command is inside the 
application of this feature, source range of addresses, then strange things happen: the 

locations between the beginning of the source range and the 
destination address are treated as a sub-range and the values 
in this sub-range are replicated throughout the source range. 



10.3.5 Comparing Data in Memory 

You can use the VERIFY command to compare two ranges of 
memory using the same format you use to move a range of 
memory from one place to another. In fact, the VERIFY 
command can be used immediately after a MOVE to make sure 
that the move was successful. 

The VERIFY command, like the MOVE command, needs a 
range and a destination. The syntax of the VERIFY command is: 

[destination < start! . jendj © 

The Monitor compares the values in the source locations with 
the values in the locations beginning at the destination address. 
If any values don't match, the Monitor displays the address at 
which the discrepancy was found and the two values that differ. 
In the example, you store data values in the range of locations 
from to $D, copy them to locations starting at $300 with the 
MOVE command, and then compare them using the VERIFY 
command. When you use the VERIFY command after you 
change the value at location 6 to SE4, it detects the change. 






£ 



BJ 
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»0:D7 F2 E9 F4 F4 E5 EE AO E2 F9 AO C3 C4 
C5 



>300cO.D® 



*300<0,D® 



3 



Like the MOVE command, the 
VERIFY command also does 
unusual things if the destination 
address is within the source range; 
see sectton 10.6, 



*6:E4 
*300<0.DQT) 

O00G-E4 CEE> 

# 

If the VERIFY command finds a discrepancy, it displays the 
address of the location in the source range whose value differs 
from its counterpart in the destination range. If there is no 
discrepancy. VERIFY displays nothing. The VERIFY command 
leaves the values in both ranges unchanged. The last opened 
location is the fast location in the source range, and the next 
changeable location is the first location in the source range, just 
as in the MOVE command. If the ending address of the range is 
less than the starting address, the values of only the first 
locations in the ranges will be compared. 



**J 
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Even though the actual contents of the 65CQ2 s internal 
registers are changing as you use the Monitor, you can 
examine the values that the registers contained at the time the 
Monitor gained control, either because you called it or because 
the program you are debugging stopped at a break (BRK). You 
can also store new register values that will be used when you 
execute a program from the Monitor using the GO command, 
described below. 
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10.4.2 Examining Registers 

Pressing CcontrolX T) and then (return) invokes the Monitor's 
EXAMINE command, which displays the stored register values 
and sets the location containing the contents of the A register 
as the next changeable location. After using the EXAMINE 
command, you can change the values in these locations by 
typing a colon and then typing the new values separated by 
spaces. In the following example, you display the registers, 
change the first two, and then display them again to verify the 
change. 

* ( control H P 

A-OA X-FF Y = D8 P-BO S=F8 
*:B0 02 

* C CONTROL H P 

A-BO X*02 Y-D8 P=BQ S=F8 

# 



J 

a 



10.4. 1 Changing Registers 

When you call the Monitor, it stores the contents of the 65C02 

registers in memory. The registers are stored in the order A. X, 

Y. P (processor status register), and S (stack pointer), starting 

at location $45. When you give the Monitor a GO command, the 

Monitor loads the registers from these five locations before it 

executes the first instruction in your program. _-** 



*« 
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10. 5 Miscellaneous Monitor Commands 

These Monitor commands enable you to change the video 
display format from normal to inverse and back, and to assign 
input and output to external devices. 

10.5. 1 Display Inverse and Normal 

The cout subroutine is described You can control the setting of the inverse-normal mask location 
in Chapter 3. used by the COUT subroutine from the Monitor so that all the 

Monitor's output will be in inverse format. The INVERSE 
command I sets the mask such that all subsequent inputs and 
outputs are displayed in inverse format. To switch the Monitor's 
output back to normal format, use the NORMAL command N. 

*0.F 



0000- 


GA 


0B OC 0D 0E OF DO 04 


0008- 


CG 


1 F0 08 CA DO F6 AS 


*CD 







0.F 



0- 


0A 0B OC 0D OE OF DO 04 


0008- 


C6 1 F0 08 CA DO F6 A6 


# ® 





*0*F 

0000- 0A 0B 0C 0D 0E OF DO 04 
0008- C6 01 F0 08 CA DO F6 A6 
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10.5.2 Back to BASIC 

If you are using one of the Apple disk operating systems 
(ProDOS or DOS), press ( contrqlX reset ) or type 

See Appendix D. 3D0G 

to return to the language you were using, with your program 
and variables intact. 

Note: If you type the latter command, make sure that the 
third character you type is a zero, not a letter O, The letter G 
is the Monitors GO command, described below in 
section 10.7. 



J 

-^ 

LL*d 

"J 

"J 

"J 



If there is no operating system in RAM r use the BASIC 

command (cqntrolX F) to leave the Monitor and enter the 

BASIC interpreter that was active when you entered the 

Monitor. (Normally this is Applesoft BASIC.) Any program or |*^ 

variables that you had previously in BASIC will be lost If you 

want to re-enter BASIC with your previous program and ^— * 

variables intact, use the CONTINUE BASIC command (£-* 

C CQNTR0L> (C"). 



U-* 



1 
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Chapter 3 lists the Apple lie port 
numbers available. 



For more information on the way 
those commands work, refer to 
section 3.1. 



10.5,3 Redirecting input and Output 

The CONTROL-P command diverts all output normally destined 
for the screen (port 0) to a device attached to one of the other 
ports, from 1 to 7. The format of the command is 

;port number] ( control H P 

A CONTROL-P command to port number will switch the 
stream of output characters back to the Apple lie's video 
display. However, use (esc) ( control ) - fc7) if the enhanced video 
firmware is active (solid-block cursor). 

In much the same way that the CONTROL-P command switches 
the output stream, the CONTROL-K command substitutes a 
device connected to a specified port for the Apple lie's normal 
input device, the keyboard. The format for the command is: 

port number; (control K IT) 



Pressing (T) ( contrqlH IT) directs the Monitor to accept input 
from the Apple He's built-in keyboard. 

The CONTROL-P and CONTROL-K commands are the exact 
equivalents of the BASIC (but not DOS and ProDOS) commands 
PR* and IN*. 



10.5.4 Hexadecimal Arithmetic 

The Monitor will also perform one-byte hexadecimal addition 
and subtraction. Just type a line in one of these formats 
followed by (return) 



; value| + value, ( return ) 
>alue: - value (return) 

The Apple lie performs the arithmetic and displays the result, as 
shown in these examples. 

*20+13 
= 33 

ma-c 

=3E 

•FF + 4 

= 03 

♦3-4 

= FF 
# 
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10.6 Special Tricks With the Monitor 

This section describes some more complex ways of using the 
Monitor commands. 

m* 



10.6. 1 Multiple Command Lines 

You can put as many Monitor commands on a single line as 
you like, as long as you separate them with spaces and the 
total number of characters in the line is less than 254, Adjacent 
single-letter commands such as (T) t (D, (D, and ® need not 
be separated by spaces. 

You can freely intermix all of the commands except the 
STORE (:) command. Since the Monitor takes all values 
following a colon and places them in consecutive memory 
locations, the last value in a STORE must be followed by a 
letter command before another address is encountered. You 
can use the NORMAL command as the required letter command 
in such cases; it usually has no effect and can be used 
anywhere. 

In the following example, you display a range of memory, 
change it, and display it again, all with one line of commands. 

•300.307 300:18 69 1 ©300.302 

0300- 00 00 00 00 00 00 00 00 

0300- 18 69 01 

* 

If the Monitor encounters a character in the input line that it 
does not recognize as either a hexadecimal digit or a valid 
command character, it executes all the commands on the input 
line up to that character, then grinds to a halt with a noisy beep 
and ignores the remainder of the input line. 
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__ 70.6.2 FM/rg Memory 

""d The MOVE command can be used to replicate a pattern of 

values throughout a range of memory. To do this, first store the 
pattern in the first locations in the range: 



—J 



rz 



h-3 

=5 



♦300: 1 1 22 33 



Remember the number of values in the pattern: in this case, it 
is 3. Use the number to compute addresses for the MOVE 
command, like this: 

; start + number < ; start . ; end-number ® 

This MOVE command will first replicate the pattern at the 
^ locations immediately following the original pattern, then 

replicate that pattern following itself, and so on until it fills the 
entire range. 



f 303<300 .32D® 

•300. 32F 

0300- 11 22 33 11 22 33 11 22 

0308- 33 11 22 33 11 22 33 11 

0310- 22 33 11 22 33 1 1 22 33 

0318- 11 22 33 11 22 33 11 22 

0320- 33 1 1 22 33 1 1 22 33 1 1 

0328- 22 33 11 22 33 11 22 33 
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You can do a similar trick with the VERIFY command to check 

whether a pattern repeats itself through memory. This is 

especially useful to verify that a given range of memory t^ 

locations all contain the same value. In this example, to see the 

VERIFY command detect the discrepancy, you first fill the 

memory range from $300 to $320 with zeros and verify it, then 

change one location and verify again: 



♦300:0 

*301<30D.31F(m) 
*301<300.31F(V) 
•304:02 



0303-00 (02) 
0304-02 (00) 



3 






*301<300.31F® ^+ 



£= 



10.6.3 Repeating Commands 

You can create a command line that repeats one or more 
commands over and over. You do this by beginning the part of 
the command line that you want to repeat with a letter 
command, such as ®. and ending it with the sequence 34 : n. 
where n is a hexadecimal number that specifies the position in 
the line of the command where you want to start repeating; for 
the first character in the line, n=0. The value for n must be 
followed with a space in order for the loop to work properly. 

This trick takes advantage of the fact that the Monitor uses an 
index register to step through the input buffer, starting at 
location $200. Each time the Monitor executes a command, it 
stores the value of the index at location $34; when that 
command is finished, the Monitor reloads the index register with 
the value at location $34. By making the last command change 
the value at location $34, you change this index so that the 
Monitor picks up the next command character from an earlier 
point in the buffer. 
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The only way to stop a loop like this is to press 
( control H reset) ; that is how this example ends. 

*QQ 300 302 34:0 (n) 



0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


0300- 


1 1 


0302- 


33 


030 





1 0.6.4 Creating Your Own Commands 

The USER command, { control H T) T forces the Monitor to jump 
to memory location $3F8. You can put a JMP instruction there 
that jumps to your own machine-language program. Your 
program can then examine the Monitor's registers and pointers 
or the input buffer itself to obtain its data. For example, here is 
a program that displays everything on the input line after the 
( control X T). The program starts at location $300; the 
command line that starts with S3F8 stores a jump to $300 at 
location S3F8. 



*300:A4 34 B9 00 02 20 ED FD C8 C9 8D D( 
F5 4C 69 FF 



*3F8:4C 00 03 



* ( control H 7) THIS IS A TEST 
THIS IS A TEST 
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10.7 Machine-Language Programs 



The main reason to program in machine language is to get 

more speed. A program in machine language can run much 

faster than the same program written in high-level languages 

such as BASIC or Pascal, but the machine-language version 

usually takes a lot longer to write. There are other reasons to 

use machine language: you might want your program to do ^ ^ 

something that isn't included in your high-level language, or you 

might just enjoy the challenge of using machine language to 

work directly on the bits and bytes. i 

Note: If you have never used machine language before, you'll 

need to learn the 65C02 instructions listed in Appendix A. To h e -* 

become proficient at programming in machine language, 

you'll have to spend some time at it, and study one of the 

books on 65C02 programming listed in the Bibliography. 



You can get a hexadecimal dump of your program or move it 

around in memory using the commands described in the 

previous sections. The Monitor commands in this section are 

intended specifically for you to use in creating, writing, and 

debugging machine-language programs. {^ 



10.7.1 Running a Program 



The Monitor has some special features that make it easier for 
you to write and debug machine-language programs, but before 
you get into that, here is a small machine-language program 
that you can run using only the simple Monitor commands 
already described. The program in the example merely displays 
the letters A through Z: you store it starting at location $300, 
examine it to be sure you typed it correctly, then type 30 0G to 
start it running. 



i 

■j 



j 

a 



The Monitor command to start execution of your 
machine-language program is the GO command. When you type 
an address and press (g), the Apple He starts executing 
machine-language instructions starting at the specified location. 
If you just press QD, execution starts at the last opened 
location The Monitor treats this program as a subroutine: it 
should end with an RTS (return from subroutine) instruction to 
transfer control back to the Monitor. 
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*300:A9 C1 20 ED FD 18 69 1 C9 DB DO F6 60 

•30Q.30C 

0300- A9 C1 20 ED FD 18 69 01 

0308- C9 DB DO F6 60 

♦300(g) 

ABCDEFGHI JKLMNQPQRSTUVWXYZ 



Since programs that translate 
assembly language into machine 
language are called assemblers, a 
program like the Monitor's LIST 
command that translates machine 
language into assembly language is 
called a disassembler 



The word mnemonic comes from 
the same root as memory and 
refers to short acronyms that are 
easier to remember than the 
hexadecimal operation codes 
themselves. For example, for clear 
carry you write CLC instead 
of Si 8. 



10.7.2 Disassembled Programs 

Machine-language code in hexadecimal isn't the easiest thing in 
the world to read and understand. To make this job a little 
easier, machine-language programs are usually written in 
assembly language and converted into machine-language code 
by programs called assemblers. 

The Monitors LIST command displays machine-language code 
in assembly-language form. Instead of unformatted hexadecimal 
gibberish, the LIST command displays each instruction on a 
separate line, with a three-letter instruction name, or mnemonic, 
and a formatted hexadecimal operand. The LIST command also 
converts the relative addresses used in branch instructions to 
absolute addresses. 

The Monitor LIST command has the format: 

| location (T) 



=3 
=3 
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The LIST command starts at the specified location and displays 
as much memory as it takes to make up a screenful! (20 lines) 
of instructions, as shown in the following example: 

*300{T) 



0300- 


A9 


C1 


0302- 


20 

FD 


ED 


0305- 


18 




0306- 


69 


01 


0308- 


C9 


DB 


030A- 


DO 


F6 


030C- 


60 




030D- 


00 




030E- 


00 




030F- 


00 




0310- 


00 




031 1- 







0312- 







0313- 


00 




0314- 







0315- 







0316- 


00 




0317- 


00 





LDA 


*$C1 


J5R 


$FDED 


CLC 




ADC 


*$01 


CMP 


*$DB 


BNE 


$0302 


RTS 




BRK 




BRK 




BRK 




BRK 




BRK 




BRK 




BRK 




BRK 




BRK 




BRK 




BRK 





J 
3 



"J 

3 
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0318- 



00 



BRK 



0319- 



00 



BRK 



The first seven lines of this example are the assembly-language 
form of the program you typed in the previous example. The 
rest of the lines are BRK instructions only if this part of memory 
has zeros in it: other values will be disassembled as other 
instructions. 

The Monitor saves the address that you specify in the LIST 
command, but not as the last opened location used by the other 
commands. Instead, the Monitor saves this address as the 
program counter, which it uses only to point to locations within 
programs- Whenever the Monitor performs a LIST command, it 
sets the program counter to point to the location immediately 
following the last location displayed on the screen, so that if 
you type another LIST command it will display another 
screenful! of instructions, starting where the previous display 
left off. 
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Here is a summary of the Monitor commands, showing the 
syntax diagram for each one. 



Examining Memory 



ladrs ( return"! 
adrsl . adrs2 Qt etuwn} 
Cr etusn] 

adrs'GD 



Displays the vaJue contained in one 
location. 

Displays the values contained m all 
locations between adrsl ; and ;adrs2 

Displays the values in up to eight 
locations following the last opened 
location. 

Lists disassembled code starting at 
'adrs, and continuing until the screen 

is full, 
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Changing the Contents of Memory 



;adrs':|val| ;val ... 



;!vai: va(!.., 



STORE command. Stores the values 
in consecutive memory locations 
starting at adrs|. 

Stores values in memory starting at 
the next changeable location. 



Moving and Comparing 



|dest;-: start lend© 

idest;-, start . end® 



The Register Command 



f CONTROL X T) 



MOVE command. Copies the values in 
the range start,.; end into the range 
begin ni rig at dest . 

VERIFY command. Compares the 
values in the range ; start;, end to 
those in trie range beginning at ;dest 



EXAMINE command. Displays the 
locations where the contents of the 
65C02's registers are stored and 
opens them for changing. 



Miscellaneous Monitor Commands 



a? 



CD 

® 

(""c omtrolX b") 
{ contrdlX jD 

[valj-t m\ 
;val -;val, 



INVERSE command. Sets inverse 
display mode. 

NORMAL command. Sets normal 
display mode. 

BASIC command. Enters the language 
currently active (normally Applesoft). 

CONTINUE BASIC command. Returns 
to the language currently active 
(normally Applesoft). 

Adds the two values and prints the 

hexadecimal result. 

Subtracts the second value from the 
first and prints the result. 
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!POrt; fC ONTHOLK P) 



-^ 



fESC") (CQNTROiK q") 



port| ( control K IT) 



CcontrolK yQ 



Redirects output to the device 
connected to port number |port . If 
port:=0, sends output to the video 
display. Use only when the enhanced 
video firmware is not active 
I checkerboard cursor) 

Redirects output to video display 
when enhanced video firmware is 
active (solid block cursor). 

Takes input from the device 
connected to port number ;port . It 
|port|=u\ accepts input from the 
keyboard, 

USER command. Jumps to the 
machine-language subroutine at 
location $3F8. 



Running and Listing Programs 



adrs .Gi 
ladrs CD 



Transfers control to the machine 
language program beginning at |adrs 

Disassembles and displays 
20 instructions starting at |adrs . 
Subsequent (T_Js display 20 more 
instructions each. 
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CD 



=3 

=3 



3 

=3 



Most of this manual describes functions — what the Apple lie 
does. This chapter, on the other hand, describes objects: the 
pieces of hardware the Apple He uses to carry out its functions. 
If you are designing a device to connect to the Apple He back 
panel, or if you just want to know more about how the Apple lie 
is built, you should study this chapter. 



/ 7. 1 Environmental Specifications 



=3 

=3 



The Apple lie is quite sturdy when used in the way it was 
intended—as a transportable computer, made for use in an 
indoor environment, You can carry it by its handle from room to 
room, but for longer trips Apple recommends that you use its 
carrying case or some other protective container (such as an 
attache case). 

Table 11-1 defines the conditions under which the Apple lie is 
designed to function properly. 

Table 11-1. Summary of Environmental Specifications 

Operating Temperature: 10° to 40° C (50° to 104* F) 

Relative Humidity: 20% to 95% 

Line Voltage: 105 to 129 VAC (normal USA voltage 

range) 

You should treat the Apple lie with the same kind of care as 
any other electrical appliance. You should protect it from 
physical abuse, and be careful not to bump it against furniture 
when you move it around. Put it in an attache case or other 



^ 
^ 
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1 1.2 Power Requirements 



i 

The electrical power that the Apple lie, and everything that 

draws power from it. is limited by the tolerances of its power r 

supply and internal voltage converter. This section describes fc - 
these limits for the USA external power supply. Appendix G 

describes them for models built for other countries. The internal i^ 

voltage converter is the same on all models. L* 

11:2.1 The External Power Supply 

If you purchased your Apple lie outside the USA. consult 
Appendix G for external power supply characteristics. 



protective covering if you carry it outside. You should also 
protect the mechanical keyboard and the electrical connectors 
inside the case from spilled liquids. 

In normal operation (with the handle locked in its down 
position), enough air flows through the openings in the case to 
keep the insides from getting too hot. If you manage to 
overheat your Apple lie— for example, by blocking the upper or 
lower ventilation openings — the first symptom will be erratic 
operation, such as unexpectedly changed data. The memory 
devices in the Apple lie are especially sensitive to heat. 

Disks are another heat-sensitive element of the system. If the 
built-in drive becomes too hot, a disk within can warp or even 
melt. 



The external power supply operates on normal household AC 

power and provides DC power to the Apple lie internal 

converter. The basic specifications of the external power supply jj ■{ 

are listed in Table 11-2. The Apple He external power supply's 

cord must be plugged into a three-wire 115-volt (nominal) outlet 

The line voltage must be in the range given in Table 11-2. 
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Warning 

Important Safety Instructions: This product is equipped with a 
three- wire grounding-type plug— a plug having a third 
(grounding) pin. This plug will only fit into a grounding-type 
AC outlet. This is a safety feature. 

If you are unable to insert the plug into the outlet contact a 
licensed electrician to replace the outlet and, if necessary, install 
a grounding conductor. 

Do not defeat the purpose of the grounding-type plug. 

Table 1t-2. Power Supply Specifications 

Line Voltage: 105 to 129 VAC, 60 Hi 

Maximum Input Power Consumption: 25 W 

Supply Voltage: +15 VDC (nominal) 

Supply Current: 1 2 A (nominal) 



1 1.2.2 The External Power Connector 

The external power supply is attached to the internal converter 
by means of a 7-pin DIN connector. The connector pins are 
identified in Figure 11-1 and Table 11-3. 

Figure 11-t. External Power Connector 




Pin Signal 



1 


Not connected 


2,3 


Signal ground 


4 


Shield ground 


5,6 


I 15 VDC 


7 


Not connected 
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Table 11-3, External Power Connector Signals 

Description 

Not connected 

Common electrical ground 

Chassis ground 

+ 15 volt DC Input to converter 



Pin Number 


Name 


1,7 




2,3 


Ground 


4 


Chassis 


5,6 


+ 15V 



Table 11-4. Internal Converter Specifications 
Input Voltage: 

Maximum Power 
Consumption: 

Supply Voltages: 
Maximum Supply Currents: 



+ 9to20VDC 




25 W 






+ 5V 


±5% 




1 2V 


- 10% 




■12V 


±10% 




+5V: 


1-5 A 




■H2V: 


0.6 A continuous 
0.9 A intermittent 






1.5 A surge (for < 


100 ms) 


-12V: 


100 mA 




<-5V: 


50 mA) 





Maximum Case Temperature: 60°C (140"F) 

The Apple lie uses a switching-type internal voltage converter. It 
is small and lightweight, and it generates less heat than other 
types of voltage converters do. 

The Apple lies voltage converter works by using the 
DC voltage input to power a variable-frequency oscillator. The 
oscillator drives a small transformer with several separate 
windings to produce the different voltages required. A circuit 
compares the voltage of the +5 volt supply with a reference 
voltage and feeds an error signal back to the oscillator circuit. 



a 



11.2. 3 The Internal Converter 

The internal converter in the Apple lie operates on from 9 to \ 

20 volts DC as provided by the external power supply or its 
equivalent. The internal converter provides enough low-voltage 
electrical power for the built-in electronics plus an external disk 
drive attached via the 19-pin connector. The basic 
specifications of the internal converter are listed in Table 11-4. 
Listed amperages are those available in addition to the current 
drawn by the Apple He itself. Minus 5 volts is derived from the 
-12 volts provided by the voltage converter. 
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The oscillator circuit uses the error signal to control the duty 
cycle of its oscillation and keep the output voltages in their 
normal ranges. 

The converter includes circuitry to protect itself and the other 
electronic parts of the Apple lie by limiting all three output 
voltages whenever it detects one of the following malfunctions; 

• any supply voltage short-circuited to ground 

• any output voltage outside the normal range. 

Any time one of these malfunctions occurs, the protection 
circuit varies the duty cycle of the oscillator, and all the output 
voltages drop to zero. 
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11.3 Apple lie Overall Block Diagram 



A full set of schematic diagrams of Figure 11-2 is an overall block diagram of the Apple lie. The 

the Apple lie appears in foltowinq sections contain more detailed diaqrams of the major 

sec,ion1114 - parts of the machine. 

Figure 11-2. Apple lie Block Diagram 
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m 11.4 The CMOS 6 5 CO 2 Microprocessor 

The Apple lie uses a CMOS 6502 (designated as 65C02) 
microprocessor as its central processing unit (CPU). The 65C02 
in the Apple lie runs at a clock rate of 1.023 MHz and performs 
up to 500,000 eight-bit operations per second. 

Note: You should not use the clock rate as a criterion for 
comparing different types of microprocessors. The 65C02 
has a simpler instruction cycle than most other 
microprocessors and it uses instruction pipelining for faster 
processing. The speed of the 65C02 with a 1 MHz clock is 
equivalent to many other types of microprocessors with clock 
rates up to 5 MHz, 

In addition to requiring lower power than earlier NMOS 6502 

processors, the 65C02 in the Apple lie provides the 
These instructions are described in programmer with 27 new instructions. However, programs that 
Appendix A. use these additional instructions will not be backward 

compatible with other Apple II series computers that are not 

equipped with a CMOS 6502. 






1 1 .4 The CMOS 65C02 Microprocessor 1 21 1 



11.4* 1 65C02 Block Diagram 

Figure 11-3 is a block diagram of the 65C02 microprocessor, 
Table 11-5 contains the general specifications of this chip. 



Figure 11-3. 65C02 Block Diagram. Copyright 1982, NCR Corporation. 
Used by permission of NCR Corporation, Dayton, Ohio. 
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The 65C02 has a sixteen-bit address bus, giving it an address 
space of 64K (two to the sixteenth power or 65536) bytes. The 
Apple lie uses special techniques to address a total of more 
than 64K: for details, refer to Chapter 2, 
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Table 1 1-5. 65C02 Microprocessor Specifications 
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Type: 

Register Complement: 



Data Bus: 
Address Bus: 
Address Range; 
Interrupts: 

Operating Voltage: 
Power Dissipation: 



65C02 

8-bit Accumulator (A) 
8-bit Index Registers (X,Y) 
8-bit Stack Pointer (S) 
8-bit Processor Status (P) 
16-bit Program Counter (PC) 

Eight bits wide 

Sixteen bits wide 

65.536 (64K) 

IRQ (maskable) 
nmi (non-maskable) 
BRK (programmed) 

I 5V ( fc 5%) 

5 mW (at 1 MHz) 



11.4.2 65C02 Timing 

The operation of the Apple lie is controlled by a set of 
synchronous timing signals, sometimes called clock signals. 
The frequency of the oscillator that generates the master timing 
signal is 14.318 MHz. Circuitry in the Apple lie uses this clock 
signal, called 14M, to produce all the other timing signals. 
These timing signals perform two major tasks: controlling the 
computing functions, and generating the video display. The 
timing signals directly involved with the operation of the 65C02 
are described in this section. Other timing signals are 
described in sections 11.6,2, 11.9.3, and 11.9.4. 

The main 65CQ2 timing signals are listed in Table 11-6, and 
their relationships are diagrammed in Figure 11-4. The 65C02 
clock signals are </>1 and </>0, complementary signals at a 
frequency of 10227 MHz, The Apple lie signal named </>0 is 
equivalent to the signal called $2 in Appendix A (it isn't 
identical- — it's a tiny bit early). 
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Figure 11-4. 65C02 Timing Signals 
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Table 11~6. 65C02 Timing Signal Descriptions 
Signal Name Description 

14M Master oscillator, 14.318 MHz; also 80-column dot clock 

VID7M Intermediate timing signal and 40-column dot clock 

Q3 Intermediate timing signal, 2.045 MHz with asymmetrical duty 

cycle 

00 Phase of 65C02 clock, 1 .0227 MHz; complement of *1 

M Phase 1 of 65C02 clock, 1.0227 MHz; complement of &Q 

The operations of the 65C02 are related to the clock signals in 
a simple way: internal during 01, external during 00. The 65C02 
puts an address on the address bus during 01. This address is 
valid not later than 110 nanoseconds after 01 goes high and 
remains valid through all of <£0. The 65C02 reads or writes data 
during 00. If the 65C02 is writing, the read/write signal is low 
during 00 and the 65C02 puts data on the data bus. The data is 
valid not later than 75 nanoseconds after ^0 goes high. If the 
65C02 is reading, the read/write signal remains high. Data on 
the data bus must be valid no later than 50 nanoseconds before 
the end of </>0. 
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Most of the circuitry that controls memory and I/O addressing in 
the Apple He is in five custom integrated circuits 

• the Memory Management Unit (MMU) 

• the Input-Output Unit (IOU) 

• the Timing Generator (TMG) 

• the General Logic Unit (GLU) 

• the Disk Controller Unit (IWM) 

The soft switches used for controlling the various I/O and 
addressing modes of the Apple He are addressable flags inside 
the MMU, IOU, and GLU. The functions of the MMU and IOU 
are not as independent as their names suggest, working 
together, they generate all of the addressing signals. For 
example, the MMU generates the RAM address signals for the 
CPU, while the IOU generates similar RAM address signals for 
the video display and most I/O hardware addresses. 
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Note: A signal name followed by an asterisk is active low, 
that is, it is true when not asserted. 

The 64K dynamic RAMs used in the Apple lie use a multiplexed 
address, as described below in the section Dynamic-RAM 
Timing (in section 11.6.2). The MMU generates this multiplexed 
address for memory reading and writing by the 65C02 CPU. 



B 
C 
r 



11.5. 1 The Memory Management Unit (MMU) 

The circuitry inside the MMU implements these soft switches, 
which are described in the following chapters: 

• Page 2 display (PAGE2): Chapter 5 

• High-resolution mode (HIRES): Chapter 5 

• Store to 80-column display (80STORE): Chapter 5 

• Select bank 2 (BANK2): Chapter 2 

• Enable bank-switched RAM (ENLCRAM): Chapter 2 j^ 

• Read auxiliary memory (RAMRD): Chapter 2 

• Write auxiliary memory (RAMWRT): Chapter 2 Ei^ 

• Auxiliary stack and zero page (ALTZP): Chapter 2 

• Reset mouse Y interrupt (RSTYINT): Chapter 9 f^ 

• Reset mouse X interrupt (RSTXINT): Chapter 9 

These switches are available on MMU pin 21 , which is Cj 

connected to bit 7 on the data bus. Figure 11-5 shows the 
MMU pinouts; Table 11-7 describes the signals. 
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Figure 1 1-5. The MMU Ptnouts 



Table 1 1-7, The MMU Signal Descriptions 



Hi 

^3 



GND 


,^ 


40 


AO 


2 


39 


*o 


3 


38 


Q3 


4 


37 


PRAS* 


5 


36 


RAO 


6 


35 


RA1 


7 


34 


RA2 


8 


33 


RA3 


9 


32 


RA4 


10 


31 


RA5 


11 


30 


RA6 


12 


29 


RA7 


13 


26 


R/W* 


14 


27 


INH* 


15 


26 


C06X* 


16 


25 


EN BO* 


17 


24 


KBD* 


18 


23 


ROMEN2* 


19 


22 


ROMEN1* 


20 


21 



A1 


Pin Number 


Name 


Description 


A2 


1 


GND 


Power and signal common 


A3 

A4 


2 


AO 


65C02 address input 


A5 
A6 


3 


■>0 


Clock phase input 


A7 


i 


Q3 


Timing signal input 


A8 
A9 


5 


PRAS* 


Memory row-address strobe 


A10 


6-13 


RAQ-RA7 


Multiplexed address output 


A11 
A12 


\A 


R/W 


65C02 read-write control signal 


A13 

A14 

A15 

1-5V 

SELIO* 


15 
16 


INH- 
C06X* 


Inhibits main memory (tied 

to I5V| 

Causes $C06x outputs to go to 
during ciQ 


CASEN* 
C07X* 

MD7 


17 
16 


EN80* 
KBD" 


Enables auxiliary RAM 
Enables keyboard data bits 0-6 




19 


ROMEN2* 


Enables ROM (tied to ROMENT) 




20 


ROMEN1* 


Enables ROM {tied to ROMEN2") 




21 


MD7 


State of MMU flags on data bus 
bit 7 




22 


C07X 


Causes $CQ7x outputs to go to 
during $0 




23 


CASEN" 


Enables main RAM 




24 


SELIO* 


Goes to during ^0 for any access 
to SCO page except SCOSx, Bx. Cx 
or Fx 




25 


+ 5V 


Power 




26-40 


A15-A1 


65C02 address Input 
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Figure 11-6, The IOU P/nouts 
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11.5.2 The Input/Output Unit (IOU) 

The circuitry inside the In put/Output Unit (IOU) implements the 
following soft switches, all described in Chapters 2 and 3: 

• Page 2 display (PAGE2) 

• High-resolution mode (HIRES) 

• Text mode (TEXT) 

• Mixed mode (MIXED) 

• 80-column display (80COL) 

• Character-set select (ALTCHAR) 

• Any-key-down (AKD) 

• Mouse movement (X0, Y0) 

• Vertical blanking interrupt (VBLINT) 

These switches are available on IOU pin 9, which is connected 
to bit 7 on the data bus. Figure 11-6 shows the MMU pinouts; 
Table 11-8 describes the signals. 

The 64K dynamic RAMs used in the Apple lie require a 
multiplexed address, as described in the section Dynamic-RAM 
Timing (in section 11.6,2). The IOU generates this multiplexed 
address for the data transfers required for display and memory 
refresh during ctock phase 1. The way this address is 
generated is described in section 11.9.1. 



Table 1 1-8. The IOU Signal Descriptions 



MvJ 


Pin Number 


Name 


SYNC* 
WNOW 


1 


GND 


CLRGAT' 
RA10- 


? 


GR 


RA9- 
VIDD6 


9 


SEGA 


VIDD7 






K3TRB 






AKD 
IOUSEUO* 


4 


SEGB 


A6 






I 5V 






Q3 






*0 

PR AS* 


5 


VC 


RA7 






RA6 






RA5 






RA4 







Description 

Power and signal common 

Graphics mode enable 

In text mode, works with VC {see 
pin 5) and SEGB to determine 
character row address 

In text mode, works with VC (see 
pin 5) and SEGA; in graphics 
mode, selects high-resolution when 
low. low-resolution when high 

Dtsplay vertical counter bit; in text 
mode, SEGA. SEGB and VC 
determine which of the eight rows 
of a character" s dot pattern to 
display, in low- resolution, selects 
upper or lower block defined by a 
byte. 



218 



Chapter 11: Hardware Implementation 



i 

a 



Table 11-8- 


-Continued, The IOU Signal Descriptions 


Pin Number 


Name 


Description 


6 


80COL* 


80'COiumn video enable 


7 


CASSO 


Reserved 


B 


SPKR 


Speaker output signal 


g 


MD7 


Internal IOU flags for data bus 
(bit 7) 


10 


YMOVE 


Detects mouse movement along 
Y axis 


11 


N.C. 


Wot used 


12 


N.C- 


Not used 


13 


PDL0/XMOVE 


Detects mouse movement along 
X axis 


14 


WW 


65C02 read-write control signal 


15 


RESET- 


Power on and reset output 


15 


IRQ* 


Maskable interrupt line to 65C02 


1 7-24 


RA0-RA7 


Video refresh multiplexed RAM 
address (phase 1 ) 


25 


PRAS" 


Row-address strobe (phase 0) 


26 


*0 


Master clock phase 


27 


Q3 


Intermediate timing signal 


28 


+ 5V 


Power 


29 


A6 


Address bit 6 from 65C02 


30 


IOUSELIO' 


Derived from the SELIO* output for 

MMU pin 24 


31 


AKD 


Any-key-down signal 


3? 


KSTRB 


Keyboard strobe signal 


33.34 


VIDD7.VIDD6 


Video display data bits 


35.36 


RA9',RA10' 


Video display conirol bits 


37 


CLRGAT* 


Color-burst gate (enable) 


38 


WNDW* 


Display blanking signal 


39 


SYNC* 


Display synchronization signal 


40 


HO 


Display horizontal timing signal 
(low bit of character counter) 
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Figure It -7. The TMG Pinouts 
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1 1.5.3 The Timing Generator (TMG) 

A custom timing generator chip (TMG) generates several timing 
and control signals in the Apple lie. The TMG pinouts are 
shown in Figure 11-7; the signals are listed in Table 11-9, 

Table 119, The TMG Signal Descriptions 
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I 5V 


Pin Number 


Name 


Description 


2 

•fc- I 


PRAS* 
(N.C.) 
PCAS T 
Q3 


1 

2 


14M 
7M 


14.318 MHz master timing signal 
input 

7.159 MHz timing signal 


•I'D 
•M 

VID7M 
LDPS' 


3 

•■5 


CREF 

HI} 


3.5795 MHz color reference timing 
signal 

Horizontal video timing signal 


J 


TMGEN* 


5 


VIDD7 


Video data bit 7 


J 




6 


SEGB 


Video timing signal 


M 




7 


T F'<- 


Video display text-modes enable 






8 


CASEN' 


RAM enable (CAS enable) 






s 


B0COI ' 


Enable 80-column display mode 




10 


GND 


Power and signal common 


& 




11 


TMGEN' 


Enable master timing 


fcr^ 




12 


LDPS* 


Video shift-register load enable 


_^ 




13 


VI07M 


Video dot clock enable, 7 MHz or 
continuous 


S-- 




14 
15 


• .1 
. .0 


Phase 1 system clock 
Phase system clock 


^ 




16 

•7 


Q3 
PCAS* 


Intermediate timing and strobe 
signal 

RAM column-address strobe 


"I 




18 


N.C. 


Reserved for testing 


d 




19 


PRAS' 


RAM row-address strobe 


\ 




20 


+ 5V 
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Figure 11-8. The GLU Pinouts 
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11.5.4 The General Logic Unit (GLU) 

The General Logic Unit is a single-chip version of the 
miscellaneous logic required for the system. It provides all RAM 
read/write timing, double-high-resolution enable/disable, soft 
switch status registers and write command registers. It also 
provides IOU control for mouse interrupts and 
double-high-resolution soft-switches. Its pin assignments are 
shown in Figure 11-8 and its signals are listed in Table 11-10, 



Table 11-10. The GLU S>gnat Descriptions 



+ 5V 


Pin Number 


Name 


SEB* 


1 


14M 


(N.C.) 
DISK* 


2.3-7 


A0.A3-A7 


7M 






CREF 






(N.C.) 


8 


PHO 


(N.C.) 






TEXT 

R/W 


9 


SELIO* 


D7 






GLUEN* 


10 


GR 




1 ! 


RESET' 



12 



GND 



Description 

Master clock (14.318 MHz) 

Address lines to select least 
significant byte of addresses on 
CO page 

Phase of 1 ,0227 MHz processor 
sync clock 

Device select for selecting most 
significant byte of the address 

Graphics mode select line 

Master reset for system; resets 
GLU 

Ground reference and negative 
supply 



13 


GLUEN' 


Enables GLU 


| 1 


MD7 


Indicates status of MMU flags on 

data bus bit 7 


15 


R'W 


Read/write qualifier input from 
processor 


16 


TEXT 


Signal used to generate video 
timing in double-high-resolution or 
not-graphics 


17,18 


N.C. 


Not used 


19 


CREF 


Color reference signal 


?u 


7M 


7 MHz clock output 


21 


DISK' 


Disk controller device select output 


22 


IOUHOLE 


Controls IOUSELIO 


23 


SEP* 


Serial controller device select 
output 


24 


Vcc 


- 5 volt supply 
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For further information on group 
code recording, refer to 
section 11.10. 



Figure 11-9. The IWM Pinouts 
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11.5.5 The Disk Controller Unit (IWM) 

The IWM is an integrated GCR (group code recording) disk 
drive controller in its state right after reset. In addition, it has a 
status register, mode register, and multiple operating modes. It 
provides both synchronous and asynchronous modes, and a 
fast mode with a data rate twice that of normal disk I/O speeds. 
Figure 11-9 shows the IWM pin assignments; Table 11-11 
describes the IWM signals. 



Table 11-11. The IWM Signal Descriptions 





Pin Number 


Name 


SEEKPH1 






SEEKPH3 


1 


SEEKPHO 


+ 5V 






Q3 






7M 
RESET* 


2 


SEEKPH2 


RDDATA 


3 


AO 


WRPROT 






DR1" 
DR2* 


4-6 


A1-A3 


D7 






D6 






D5 


7 


DISK* 


D4 







WRDATA 



Description 

Stepper motor control phase 0. 
One of four programmable disk 
drive motor phase outputs. 

Stepper motor control phase 2 

The data input to the state bit 

selected by A1 to A3 

These three inputs select one of 
the eight bits in the state register 
to be updated. 

Device enable. The falling edge of 
DISK* latches information 
on A1-A3. The rising edge of 
either 03 or DISK* qualifies write 
register data. 

The serial data output. Each 1-bit 
causes a transition on this output. 






UUi 



£- 



222 



9 


WRREQ* 


This signal is a programmable 
buffered output line. 


At^ 


10*13 


D0-D3 


D0-D7 make up the bidirectional 
data bus. 


£- 


14 


GND 


Ground reference and negative 
supply 


15-18 


D4-D7 


The remaining bits of the 
bidirectional data bus 


£ 


19 


DR2" 


Drive 2 select 




20 


DR1* 


Drive 1 select 




2' 


WRPROT 


Write-protect input; this can be 
polled via bit 7 of the status 
register, 


* 
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Table J 1-11— Continued. The IWM Signal Descriptions 



Pin Number 
22 

23 



24 
25 

26 
27 



Name 
ROD ATA 

RESET" 



7M 
Q3 

Vcc 

SEEKPH3 

SEEKPH1 



Description 

Serial data input line. The IWM 
synchronizes the falling transition 
of each pulse. 

IWM reset: places all IWM outputs 
in their inactive state and sets all 
stale and mode register bits to 
zero. 

7 MHz clock input 

A 2.0 MHz clock input used to 
qualify the timing ot the serial data 
being written or read. 

The 1 5 volt supply 

Stepper motor control phase 3 

Stepper motor control phase 1 



=3 
=3 



11.6 Memory Addressing 



The 65C02 microprocessor can address 65.536 locations. The 
Apple lie uses this entire address space, and then some: some 
areas in memory are used for more than one function. The 
following sections describe the memory devices used in the 
Apple lie and the way they are addressed. Input and output 
also use portions of the memory address space; refer to 
Chapter 2 for information. 
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Figure 11-10 illustrates the overall memory bus organization and 
memory selection signals. 

Figure 11-10. Memory Bus Organization 
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Note: Some Apple lie's have ROMs with 27xx designations, 
some have 23xx, They are functionally equivalent. 



11.6.1 ROM Addressing 

In the Apple He the following programs are permanently stored 
in a type 23128 16K by 8-bit ROM (Figure 11-11). 

• Applesoft editor and interpreter 

• Monitor 

• Enhanced video firmware. 
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Figure 11-11. The 23128 ROM 

Pinouts 




Figure 11-12. The 2316 ROM 
Pinouts 




Figure 11-13. The 2364 ROM 

Pinouts 
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The ROM is enabled by two signals called ROMEN1 and 
ROMEN2. (In the Apple lie, ROMEN1 and ROMEN2 are 
electrically connected,) The segment of the ROM enabled by 
ROM EN 1 occupies the memory address space from SC100 
to SDFFF. The address space from $C300 to SC3FF and much 
of $C800 to $CFFF contains the enhanced video firmware. 

These ROM address allocations are approximately true (some 
space sharing takes place): 

• ROM addresses $C000 to SCOFF are never available. 

• ROM addresses $C10Q and SC200 are entry points to 
firmware for serial ports 1 and 2, respectively. 

• ROM address $C400 is entry point to mouse interface 
support. 

• ROM addresses SC500 to $C5FF are reserved. 

• ROM address $C600 is entry point to firmware for the 
built-in and external disk drives. The built-in drive is 
considered slot 6 drive 1 or its equivalent. The external drive 
is considered slot 6 drive 2. 

• ROM addresses starting at SC700 support (from the Monitor) 
the external drive as if it were slot 7 drive 1, for 
external-drive startup only. 

Addresses SD000 to SF7FF contain the Applesoft BASIC 
interpreter; addresses $F800 through $FFFF contain the Monitor 
firmware. 

The other ROMs in the Apple lie are a type 2316 ROM 
(Figure 11-12) used for the keyboard character decoder, and a 
type 2364 ROM (Figure 11-13) used for character sets for the 
video display. This 2364 ROM is rather large because it 
includes a section of straight-through bit-mapping for the 
graphics modes. This way, graphics display video can pass 
through the same circuits as text without additional switching 
circuitry. 
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7 1.6.2 RAM Addressing 

The RAM (programmable) memory in the Apple lie is used both 
for program and data storage and for the video display. The 
areas in RAM that are used for the display are accessed both 
by the 65C02 microprocessor and by the video display circuits. 
In some computers, this dual access results in addressing 
conflicts (cycle stealing) that can cause temporary dropouts in 
the video display. This problem does not occur in the Apple lie, 
thanks to the way the microprocessor and the video circuits 
share the memory. 

The memory circuits in the Apple lie take advantage of the 

two-phase system clock described in section 11,4.2 to 
interleave the microprocessor memory accesses and the display 
memory accesses so that they never interfere with each other. 
The microprocessor reads or writes to RAM only during </>0. and 
the display circuits read data only during #1, 

Dynamic-RAM Refreshment 

The image on a video display is not permanent; it fades rapidly 

and must be refreshed periodically. To refresh the video display, 

the Apple lie reads the data in the active display page and 

sends it to the display. To prevent visible flicker in the display, 

and to conform to standard practice for broadcast video, the 

Apple He refreshes the display sixty times per second. -** 

The dynamic RAM devices used in the Apple lie also need a 

kind of refreshment, because the data is stored in the form of ^* 

electric charges which diminish with time and must be 

replenished every so often. The Apple lie is designed so that 

refreshing the display also refreshes the dynamic RAMs. The <-— 

next few paragraphs explain how this is done. lu> 

The job of refreshing the dynamic RAM devices is minimized by 

the structure of the devices themselves. The individual data 

cells in each RAM device are arranged in a rectangular array of 

rows and columns. When the device is addressed, the part of 

the address that specifies a row is presented first, followed by 

the address of the column. Splitting information into parts that fct - ^ 

follow each other in time is called multiplexing. Since only half 

of the address is needed at one time, multiplexing the address — *^ 

reduces the number of pins needed for connecting the RAMs 

(Figure 11-14). 
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Different manufacturers 64K RAMs have cell arrays of either 
128 rows by 512 columns or 256 rows by 256 columns. Only 
the row portion of the address is used in refreshing the RAMs 

Now consider how the display is refreshed- As described in 
section 11.9.1. the display circuitry generates a sequence of 
8.192 memory addresses in high-resolution mode; in text and 
low-resolution modes, this sequence is the 1 ,024 display-page 
addresses repeated eight times. The display address cycles 
through this sequence 60 times a second, or once every 
17 milliseconds. The way the low-order address lines are 
assigned to the RAMs, the row address cycles through all 
256 possible values once every two milliseconds (see 
Table 11-12). This more than satisfies the refresh requirements 
of the dynamic RAMs. 

Table 11-12, RAM Address Multiplexing 
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Dynamic-RAM Timing 

The Apple He's microprocessor clock runs at a speed of 
1,023 MHz. but the interleaving of CPU and display cycles 
means that the RAM is being accessed at a 2 MHz rate, or a 
cycle time of just under 500 nanoseconds. Data for the CPU is 
strobed by the falling edge of $0, and display data is strobed 
by the falling edge of 01, as shown in Figure 11-15, 
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Figure 11- IS. RAM Timing Signals 
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The RAM timing looks complicated because the RAM address 
is multiplexed, as described in the previous section. The MMU 
takes care of multiplexing the address for the CPU cycle, and 
the IOU performs the same function for the display cycle. The 
multiplexed address is sent to the RAM ICs over the lines 
labeled RA0-RA7 (Table 11-13). Along with the other timing 
signals, the TMG generates two signals that control the RAM 
addressing: row-address strobe (RAS) and column-address 
strobe (CAS). 
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Table 11-13. RAM Timing Signals 

Signal 
"-* Name Description 

^ 4>0 Clock phase {CPU phase) 

■""« #1 Clock phase 1 (display phase) 

RAS Row-address strobe 

■ j CAS Column-address strobe 

Q3 Alternate RAM /Column-address strobe 

1 RA0-RA7 Multiplexed address bus 

MDQ-MD7 Internal data bus 

"^ . 

■ 11.7 The Keyboard 

■^3 "The Apple lie's keyboard is a matrix of keyswitches connected 

to an AY-3600-type keyboard decoder via a ribbon cable and a 

mm , 26-pin connector (Figure 11-16). The AY-3600 scans the array 

mm izi of keys over and over to detect any keys pressed. The 

scanning rate is set by the external resistor-capacitor network 

^_ made up of C46 and R6. The debounce time is also set 

*- ^ externally, by C45. 

The AY-3600's outputs include five bits of key code plus 
Tlj separate lines for CONTROL, SHIFT, any-key-down, and 

keyboard strobe. The any-key-down and keyboard-strobe lines 

are connected to the IOU, which addresses them as soft 
2 switches. The key-code line, along with CONTROL and SHIFT, 

"— are inputs to a separate 2316 ROM, The ROM translates them 

to the character codes that are enabled onto the data bus by 
^j signals named KBD* and ENKBD*. The KBD* signal is enabled 

— by the MMU whenever a program reads location $C000, as 

described in Chapter 2. 

=3 
=3 
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Figure 11-16. Keyboard Circuit Diagram 
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Figure 11-17 illustrates the events that occur when a key is 
pressed, when the keypress is detected by a program, and 

when a key is pressed and held for more than about a second. 



Figure 11-17, Keyboard Signals 
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11.8 The Speaker 



AUD is an audio-amplifier hybrid 
circuit, 



The Apple He's built-in loudspeaker is controlled by a single bit 
of output from the Input/Output Unit (IOU), amplified by a hybrid 
circuit (Figure 11-18). 

Figure 11-18. Speaker Circuit Diagram 
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11.8.1 Volume Control 

There is a 500-ohm variable resistor feeding anywhere from 
to 5 volts to pin 5 of AUD to control the speaker volume. This 
potentiometer controls the volume of both the built-in speaker 
and whatever is plugged into the output jack. 



11.8.2 Output Jack 

Next to the volume control, along the lower-left side of the 
Apple lie case, there is a 3,5 mm stereo miniphone jack. 
Although speaker output is monaural, the jack accommodates 
stereo headphone plugs (as well as monaural, of course). 
providing sound to both channels. Inserting a headphone plug 
disconnects the internal Apple He speaker. 
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11.9 The Video Display 



The Apple lie produces a video signal that creates a display on 
a standard video monitor or, if you add an RF modulator, on a 
black-and-white or color television set. The video signal is a 
composite made up of the data that is being displayed plus the 
horizontal and vertical synchronization signals that the video 
monitor uses to arrange the lines of display data on the screen. 

Note: Apple lie computers manufactured for sale in the USA 
generate a video signal that is compatible with the standards 
set by the NTSC (National Television Standards Committee). 
Apple lies used in European countries require an external 
adapter to provide video that is compatible with the standard 
used there, which is called PAL (for phase alternating lines). 
This manual describes only the NTSC version of the video 
circuits. 

The display portion of the video signal is a time-varying voltage 
generated from a stream of data bits, where a 1 corresponds to 
a voltage that generates a bright dot, and a to a dark dot. The 
display bit stream is generated in bursts that correspond to the 
horizontal lines of dots on the video screen. The signal named 
WNDW* is low during these bursts. 

During the time intervals between bursts of data, nothing is 
displayed on the screen. During these intervals, called the 
blanking intervals, the display is blank and the WNDW* signal 
is high. The synchronization signals, called sync for short, are 
produced by making the signal named SYNC* low during 
portions of the blanking intervals. The sync pulses are at a 
voltage equivalent to blacker-than-black video and don't show 
on the screen. 



11.9.1 The Video Counters 

The address and timing signals that control the generation of 
the video display are all derived from a chain of counters inside 
the IOU. Only a few of these counter signals are accessible 
from outside the IOU, but they are all important in 
understanding the operation of the display generation process, 
particularly the display memory addressing described in the 
next section. 
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The horizontal counter is made up of seven stages: HO, H1, 
H2, H3. H4, H5, and HPE*. The input to the horizontal counter 
is the 1 MHz signal that controls the reading of data being 
displayed. The complete cycle of the horizontal counter consists 
of 65 states. The six bits HO through H5 count normally from 
to 64, then start over at 0. Whenever this happens, HPE" forces 
another count with HO through H5 held at zero, thus extending 
the total count to 65, 



j 



2 



The IOU uses the forty horizontal count values from 25 
through 64 in generating the low-order part of the display data 
address, as described in section 11.9.3. The IOU uses the count 
values from to 24 to generate the horizontal blanking, the 
horizontal sync pulse, and the color-burst gate 

When the horizontal count gets to 65 f it signals the end of a line 

by triggering the vertical counter. The vertical counter has nine 

stages: VA, VB, VC, VO. V1 , V2, V3, V4, and V5. When the 

vertical count reaches 262, the IOU resets it and starts counting fc -- 

again from zero. Only the first 192 scanning lines are actually 

displayed; the IOU uses the vertical counts from 192 to 262 to 

generate the vertical blanking and sync pulse. Nothing is 

displayed during the vertical blanking interval. {The vertical line 

count is 262 rather than the standard 262.5 because, unlike 

normal television, the Apple lie's video display is not interlaced.) 



E* 



1 7. 9.2 Display Memory Addressing J£- 

As described in section 5.7, data bytes are not stored in 

memory in the same sequence in which they appear on the ^ 

display. You can get an idea of the way the display data is •* 

stored by using the Monitor to set the display to graphics 

mode, then storing data starting at the beginning of the display gjj£ 

page at hexadecimal S400 and watching the effect on the " 

display. If you do this, you should use the graphics display 

instead of text to avoid confusion: the text display is also used 

for Monitor input and output. 

If you want your program to display data by storing it directly 
into the display memory, you must first transform the display 
coordinates into the appropriate memory addresses, as shown 
in Chapter 2, The descriptions that follow will help you 
understand how this address transformation is done and why it 
is necessary. 
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The requirements for RAM 
refreshing are discussed in 

section 11.6.2. 



The address transformation that folds three rows of forty 
display bytes into 128 contiguous memory locations is the same 
for all display modes, so it is described first. The differences 
among the different display modes are described in 
section 11.9.4. 



11.9.3 Display Address Mapping 

Consider the simplest display on the Apple lie, the 40-column 
text mode. To address forty columns requires six bits, and to 
address twenty-four rows requires another five bits, for a total 
of eleven address bits. Addressing the display this way would 
involve 2048 (two to the eleventh power) bytes of memory to 
display a mere 960 characters. The 80-column text mode would 
require 4096 bytes to display 1920 characters. The leftover 
chunks of memory that were not displayed could be used for 
storing other data, but not easily, because they would not be 
contiguous. 

Instead of using the horizontal and vertical counts to address 
memory directly, the circuitry inside the IOU transforms them 
into the new address signals described below. The transformed 
display address must meet the following criteria: 

• Map the 960 bytes of 40-column text into only 1 024 bytes 

• Scan the low-order address to refresh the dynamic RAMs 

• Continue to refresh the RAMs during video blanking. 

The transformation involves only horizontal counts H3, H4, 
and H5, and vertical counts V3 and V4. Vertical count bits 
VA. VB, and VC address the lines making up the characters, 
and are not involved in the address transformation. The 
remaining low-order count bits, HO. HI, H2. V0, V1, and V2 are 
used directly, and are not involved in the transformation. 

The IOU performs an addition that reduces the five significant 
count bits to four new signals called SO, S1, S2, and S3, where 
S stands for sum. Figure 11-19 is a diagram showing the 
addition in binary form, with V3 appearing as the carry in and 
H5 appearing as its complement H5\ A constant value of one 
appears as the low-order bit of the addend. The carry bit 
generated with the sum is not used. 
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Figure 11-J9. Display Address Transformation 
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If this transformation seems terribly obscure, try it with actual 
values. For example, for the upper-left corner of the display, 
the vertical count is zero and the horizontal count is 24: 
HO, H1 r H2, and H5 are zeroes, and H3 and H4 are ones. The 
value of the sum is zero, so the memory location for the first 
character on the display is the first location in the display page, 
as you might expect. 

Horizontal bits HO, H1, and H2 and sum bits SO, S1, and S2 
make up the transformed horizontal address (AO through A6 in 
Table 11-14). As the horizontal count increases from 24 to 63. 
the value of the sum (S3 S2 S1 SO) increases from zero to four 
and the transformed address goes from to 39, relative to the 
beginning of the display page. 

The low-order three bits of the vertical row counter are VO, V1 , 
and V2. These bits control address bits A7, A8, and A9, as 
shown in Table 11-14, so that rows through 7 start on 
128-byte boundaries. When the vertical row counter reaches 8, 
VO, V1, and V2 are zero again, and V3 changes to one. If you 
do the addition in Figure 11-19 with H equal to 24 (the 
horizontal count for the first column displayed) and V equal 
to 8, the sum is 5 and the horizontal address is 40: the first 
character in row 8 is stored in the memory location 40 bytes 
from the beginning of the display page. 
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Figure 11-20. 40-Column Text Display Memory. Memory locations marked with a 
double asterisk (") are screen holes, described in section 2.5.1. 
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Figure 11-20 shows how groups of three forty-character rows 
are stored in blocks of 120 contiguous bytes starting on 
128-byte address boundaries. This diagram is another way of 
describing the display mapping shown in Figure 5-5. Notice that 
the three rows in each block of 120 bytes are not adjacent on 
the display. 
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Address bits marked with double 
asterisks (") are different for 
different modes: see Table 11-15 
and section 11.9.4. 
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Table 11-14 shows how the signals from the video counters are 




assigned to the address lines. HO 


H1 


and H2 are 


!j 


horizontal-count bits, and VO, V1, 


and V2 are vertical-count bits. 


SO, S1. S2 and S3 are the folded address bits described above. 
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11.9.4 Video Display Modes 

The different display modes all use the address-mapping 
scheme described in section 1 1 ,9.3, but they use 
different-sized memory areas in different locations. 
Section 11.9.4 describes the addressing schemes and the 
methods of generating the actual video signals for the different 
display modes. Figure 11-21 illustrates the video display 
circuits discussed in this section. 
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Figure 11-21. Video Display Circuits 
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Text Displays 

The text and low-resolution graphics pages begin at memory 
locations $400 and $800. Table 11-15 shows how the 
display-mode signals control the address bits to produce these 
addresses. Address bits A10 and A11 are controlled by the 
settings of PAGE2 and 80STORE, the display-page and 
80-column-video soft switches. Address bits A12, A13, and A14 
are set to zero. Notice that 80STORE active inhibits PAGE2; 
there is only one display page in 80-column mode. 

The low-order six bits of each data byte reach the character 
generator directly, via the video data bus V1D0-VID5. The two 
high-order bits are modified by the 10 U to select between the 
primary and alternate character sets and are sent to the 
character generator on lines RA9 and RA10. 

The data for each row of characters are read eight times, once 
for each of the eight lines of dots making up the row of 
characters. The data bits are sent to the character generator 
along with VA, VB, and VC, the low-order bits from the vertical 
counter. For each character being displayed, the character 
generator puts out one of eight stored bit patterns selected by 
the three-bit number made up of VA, VB, and VC. 

The bit patterns from the character generator are loaded into 
the 74166 parallel-to-serial shift register and output as a serial 
bit stream that goes to the video output circuit (Figure 11-21). 
The shift register is controlled by signals named LDPS* (for load 
parallel-to-serial shifter) and VID7M (for video 7 Mhz). In 
40-column mode, LDPS* strobes the output of the character 
generator into the shift register once each microsecond, and 
VID7M shifts the bits out at 7 MHz (Figure 11-22). 

The addressing for the 80-column display is exactly the same 
as for the 40-column display: the 40 columns of display memory 
in auxiliary memory are addressed in parallel with the 
40 columns in main memory. The data from these two 
memories reach the video data bus (lines VID0-VID7) via 
separate 74LS374 three-state buffers. These buffers are loaded 
simultaneously (at the rising edge of <p0), but their outputs are 
sent to the character generator alternately by the falling edge 
of (t*Q and </)1. In 80-column mode, LDPS* loads data from the 
character generator into the shift register twice during each 
microsecond, once during $0 and once during </j1, and VID7M 
remains low, enabling the clock continuously at 14M 
(Figure 11-23). 
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Low-Resolution Display 

In the graphics modes, VA and VB are not used by the 
character generator, so the IOU uses lines SEGA and SEGB to 
transmit HO and HIRES*, as shown in Table 11-16. 

Table 11-16. Character-Generator Control Signals 

Display Mode SEGA SEGB SEGC 

Text VA VB VC 

Graphics HO HIRES* VC 

The low-resolution graphics display uses VC to divide the eight 
display lines corresponding to a row of characters into two 
groups of four lines each. Each row of data bytes is addressed 
eight times, the same as in text mode, but each byte is 
interpreted as two nibbles. Each nibble selects one of sixteen 
colors. During the upper four of the eight display lines, VC is 
low and the low-order nibble determines the color. During the 
lower four display lines. VC is high and the high-order nibble 
determines the color. 

The bit patterns that produce the low-resolution colors are read 
from the character-generator ROM in the same way the bit 
patterns for characters are produced in text mode. The 741 66 
parallel-to-serial shift register converts the bit patterns to a 
serial bit stream for the video circuits (Figure 11-21). 

The video signal generated by the Apple lie includes a short 
burst of 3.58 MHz signal that is used by an NTSC color monitor 
or color TV set to generate a reference 3.58 MHz color signal. 
The Apple lies video signal produces color by interacting with 
this 3,58 MHz signal inside the monitor or TV set. Different bit 
patterns produce different colors by changing the duty cycles 
and delays of the bit stream relative to the 3.58 MHz color 
signal. To produce the small delays required for so many 
different colors, the shift register runs at 14 MHz and shifts out 
14 bits during each cycle of the 1 MHz data clock. To generate 
a stream of fourteen bits from each eight-bit pattern read from 
the ROM, the output of the shift register is connected back to 
the registers serial input to repeat the same eight bits; the last 
two bits are ignored the second time around. 

Each bit pattern is output for the same amount of time as a 
character: 1.02 microseconds. Because that is exactly enough 
time for three and a half cycles of the 3.58 MHz color signal 
the phase relationship between the bit patterns and the signal 
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changes by a hall cycle for each successive pattern. To 
compensate for this, the character generator puts out one of 
two different bit patterns for each nibble, depending on the 
state of HO, the low-order bit of the horizontal counter. 

High-Resolution Display 

The high-resolution graphics pages begin at memory locations 
$2000 and $4000 (decimal 8192 and 16384). These page 
addresses are selected by address bits A13 and A14. In 
high-resolution mode, these address bits are controlled by 
PAGE2 and 80STORE, the signals controlled by the 
display-page (PAGE2) and 80-column-video (80COL) soft 
switches. As in text mode, 80STORE inhibits addressing of the 
second page because there is only one page of 80-column text 
available for mixed mode. 

In high-resolution graphics mode, the display data are still 
stored in blocks like the one shown in Figure 11-20, but there 
are eight of these blocks. As Tables 11-14 and 11-15 show, 
vertical counts VA, VB, and VC are used for address bits 
A10, A11, and A12, which address eight blocks of 1024 bytes 
each. Remember that in the display VA. VB, and VC count 
adjacent horizontal lines in groups of eight. This addressing 
scheme maps each of those lines into a different 1024-byte 
block. 

It might help to think of this scheme as a kind of eight-way 
multiplexer: it's as if eight text displays were combined to 
produce a single high-resolution display, with each text display 
providing one tine of dots in turn, instead of a row of 
characters. 

The high-resolution bit patterns are produced by the 
character-generator ROM. In this mode, the bit patterns simply 
reproduce the seven bits of display data. The low-order six bits 
of data reach the ROM via the video data bus VID0-VID5. The 
IOU sends the other two data bits to the ROM via RA9 and 
RA10. 

The high-resolution colors described in Chapter 2 are produced 
by the interaction between the video signal the bit patterns 
generate and the 3.58 MHz color signal generated inside the 
monitor or TV set. The high-resolution bit patterns are always 
shifted out at 7 MHz, so each dot corresponds to a half-cycle of 
the 3.58 MHz color signal. Any part of the video signal that 
produces a single white dot between two black dots, or vice 
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versa, is effectively a short burst of 3.58 MHz and is therefore 
displayed as color. In other words, a bit pattern consisting of ^^ 

alternating ones and zeros gets displayed as a line of color. The 
high-resolution graphics subroutines produce the appropriate bit 
patterns by masking the data bits with alternating ones and ^ 

zeros. ^j - 

To produce different colors, the bit patterns must have different 

phase relationships to the 3.58 MHz color signal. If alternating 

ones and zeros produce a certain color, say green, then 

reversing the pattern to zeros and ones will produce the 

complementary color, purple. As in the low-resolution mode, 

each bit pattern corresponds to three and a half cycles of the ■* - 

color signal, so the phase relationship between the data bits 

and the color signal changes by a half cycle for each 

successive byte of data. Here, however, the bit patterns 

produced by the hardware are the same for adjacent bytes; the 

color compensation is performed by the high-resolution 

software, which uses different color masks for data being 

displayed in even and odd columns. 

To produce other colors, bit patterns must have other timing £* 

relationships to the 3.58 MHz color signal. In high-resolution 

mode, the Apple lie produces two more colors by delaying the ^ 

output of the shift register by half a dot (70 ns), depending on Jj - 

the high-order bit of the data byte being displayed, (The 

high-order bit doesn't actually get displayed as a dot, because ^-* 

at 7 MHz there is only time to shift out seven of the eight bits.) i* - 

As each byte of data is sent from the character generator to the 

shift register, high-order data bit D7 is also sent to the TMG. 

If D7 is off, the TMG transmits shift-register timing signals m 

LOPS' and VID7M normally. If D7 is on, the TMG delays LDPS* 

and VID7M by 70 nanoseconds, the time corresponding to half 

a dot. The bit pattern that formerly produced green now 

produces orange; the pattern for purple now produces blue. 

A Note About Timing: For 80-column text, the shift register is * 

clocked at twice normal speed. When 80-column text is used 

with graphics in mixed mode, the TMG controls shift-register 

timing signals LDPS* and VID7M so that the graphics portion 

of the display works correctly even when the text window is 

in 80-column mode. ^~ 
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Double -High - Resolution Display 

Double-high-resolution graphics mode displays two bytes in the 
time normally required for one, but it uses High-resolution 
Graphics Pages 1 and 1X instead of Text and Low-resolution 
Pages 1 and 1X, 

Note: There is a second pair, HRP2 and HRP2X, which can 
be used to display a second double-high-resolution page. 

Double-high-resolution graphics mode displays each pair of data 
bytes as 14 adjacent dots, seven from each byte. The 
high-order bit (color-select bit) of each byte is ignored. The 
auxiliary-memory byte is displayed first, so data from auxiliary 
memory appears in columns 0-6, 14-20, and so on, up to 
columns 547-552. Data from main memory appears in 
columns 7-13, 21-27, and so on, up to 553-559. 

As in 80-column text, there are twice as many dots across the 
display screen, so the dots are only half as wide. On a TV set 
or low-bandwidth (less than 14 MHz) monitor, single dots will be 
dimmer than normal 



RGB stands for red, green and 

blue and identifies a type of color 
monitor that uses independent 
inputs for the three primary colors. 



For further information about 
double-high-resolution graphics 
display, refer to the Bibliography. 



Note: Except for some expensive RGB-type color monitors, 
any video monitor with a bandwidth as high as 14 MHz will 
be a monochrome monitor. Monochrome means one color: a 
monochrome video monitor can have a screen color of white, 
green, orange, or any other single color. 

The main memory and auxiliary memory are connected to the 
address bus in parallel, so both are activated during the display 
cycle. The rising edge of 00 clocks a byte of main memory data 
into the video latch, and a byte of auxiliary memory data into 
the 80 latch (Figure 11-21). 

Phi 1 enables output from the (auxiliary) 80 latch, and 
4>0 enables output from the (main) video latch. Output from both 
latches goes to CHARGEN. where GR and SEGB* select 
high-resolution graphics. LDPS operates at 2 MHz in this mode, 
alternately gating the auxiliary byte and main byte into the 
parallel-to-serial shift register. VID7M is active (kept true) for 
double-high-resolution display mode, so when it is ANDed 
with 14M. the result is still 14M. The 14M serial clock signal 
gates shift register output to VID, the video display hybrid 
circuit, for output to the display device. 
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Figure 11-22. 7 MHz Video Timing Signals (40-Column, Low-Resolution and High-Resolution Display) 



7M 



*0 



*1 — 



9- 



Video Phase 



CPU Phase 



DATA BUS " X > ? 

I 



OUTPUT BUS intoSPI (Shift Register) 



SPI Serial Output (VID7M and 14M) 



VIDEO LATCH 


x 




zzx 














LDPS* ANDEN8CT 


I 


i r 




VIDEO BUS into CHARGEN 


X 




X 



X 



}< 



1 i I 1 I I I 1 



246 



Chapter 11: Hardware Implementation 



H 

3 

a 

a 



—4 



Figure 11-23, 14 MHz Video Timing Signals (60-Column and Double-High-Resolution Display) 
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VID is a video-amplifier hybrid 
circuit. 



11.9.5 Video Output Signals 

The stream of video data generated by the display circuits 
described above goes to a hybrid circuit (VID) that adjusts the 
signals to the proper amplitudes and conditions the color burst. 

The resulting video signal is an NTSC-compatible 
composite-video signal that can be displayed on a standard 
video monitor. The signal is similar to the EIA (Electronic 
Industries Association) standard positive composite video. This 
signal is available in two places in the Apple lie (Figure 11-24): 

• at the phono jack on the back of the Apple lie 

• at the video expansion connector (pin 12) on the back panel. 

(Table 11-17). 

Figure 1 1-24. Video Output Back Panel Connectors 
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Video Video Output Connector 

Expansion Connector (For a Monitor) 

(For an RF Modulator 
or Special Adaptor) 
(See Fig. 11-25) 



mM 



Monitor Output 

The sleeve of the phono jack at the center of the Apple lie 
back panel is connected to ground and the tip is connected to 
the video output through a resistor network that attenuates it to 
about 1 volt and matches its impedance to 75 ohms. This 
arrangement is suitable for most video monitors. 
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Video Expansion Output 

The back panel of the Apple lie has a DB-15 connector for 
sophisticated video interfaces external to the computer. 
Figure 11-25 shows the pin assignments for this connector; 
Table 11-17 describes the signals. 

In Table 11-17, the column labeled Der/V indicates what clock 
signals the video signals are derived from. LDPS, CREF and 
PRAS have a maximum delay of 30 ns from the appropriate 
14 MHz rising edge. SEROUT is clocked out of a 74LS166 by 
the rising edge of 14M and has a maximum delay of 35 ns. 
VIDD7 is driven from a 74LS374 and has a maximum delay of 
28 ns from the rising and (if 80-column) falling edges of 01. 

To align CREF so it is in the same phase at the beginning of 
every line, certain clock signals must be stretched. This stretch 
is for one 7M cycle (140 ns), and occurs at the end of each 
video line. All timing signals except 14M, 7M and CREF are 

stretched. 

Warning 

The signals at the DB-15 on the Apple lie are not the same as 
those at the DB-15 on the Apple III. Do not attempt to plug a 
cable intended for one into the other 



Warning 

Several of these signals, such as 14 MHz, must be buffered 

within about four inches (10 cm) of the back panel connector — 

preferably inside a container directly connected to the back 

panel. For technical information, contact Apple Technical 

Support. 
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Figure 11-25. The Video Expansion Connector Pinouts 
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Table 11-17, The Video Expansion Connector Signals 



Pin 



Name 



Description 



11 



12 



<*0 TEXT 

14M 
Q3 SYNC 

PRAS SEGB 

1VS0UND 
14M LDPS* 

PRAS WNDW* 

+ 12 V 
14M PRAS' 

PRAS GR 

14M SEROUT* 

NTSC 



13 




GND 


14 


■ 


VIDD7 


15 


14M 


CREF 



Video text signal from TMG; set 
to inverse of GR, except in 

double-high-resolution mode 

14 MHz master timing signal from 
the system oscillator 

Display horizontal and vertical 
synchronization signal from IOU 
pin 39 

Display vertical counter bit from 
IOU pin 4; in text mode indicates 
second low-order vertical counter; 
in graphics mode indicates 
low- resolution 

One- volt sound signal from pin 5 
of the audio hybrid circuit (AUD) 

Video shift-register load enable 
from pin 12 of TMG 

Active area display blanking; 
includes both horizontal and 
vertical blanking 

Regulated +12 volts DC; can 
drive 350 mA 

RAM row-address strobe from 
TMG pin 19 

Graphics mode enable from IOU 
pin 2 

Seri ali zed char acter-generato r 
output from pin 1 of the 74LS166 
shift register 

Composite NTSC video signal 

from VID hybrid chip 

Ground reference and supply 

From 74LS374 video latch; causes 
half-dot shift if high 

Color reference signal from TMG 
pin 3; 3.58 MHz 
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Warning 

Use caution — The maximum allowable current drain of +12 V 

regulated power at the video expansion connector is 

300 mi/liamps. if the external device draws more than this, it 

can damage the computer or cause the power supply to shut 

down. 



11.10 Disk I/O 



Disk I/O — for both the built-in and the external drive — is 
supported by the IWM disk controller unit. The external drive is 
attached via a DB-19 connector. Figure 11-26 shows this 
connector. Table 11-18 describes the pin assignments. Supply 
voltages come from the power supply; all other signals come 
from the IWM, described in section 11.5.5. 

Figure 1 1-26. Disk Drive Connector 
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+ SV 


15 


WRREQ* 


7.8 


+ 12V 


16 


N.C, 
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EXTINT' 


17 


DR2* 


iC 


WRPROT 


18 


RDOATA 


11 


SEEKPHO 


19 


WRDATA 


12 


SEEKPH1 







Warning 

The power available at this connector is for a Disk If or similar 
drive only. Do not use power from the external disk connector 
for any other purpose — you may damage the internal voltage 
converter. To derive external power for an attached device, use 
one of the other connectors and observe the current limits 
given in this manual. 
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Table 1 1- 18, Disk Drive Connector Signals. "Refer to the warning preceding this 
table. 



Connector 






Pin Number 


Name 


Description 


1,2.3,4 


GND 


Ground reference and supply 


6 


+ 5 V 


+ 5 vott supply" 


7,8 


+ 12 


+ 12 volt supply** 


9 


EXTINT* 


External interrupt 


in 


WRPROT 


Write-protect input 


11-14 


PH<M 


Motor phase 0-4 output 


15 


WRREQ* 


Write Request 


17 


on i ■ 


Drive 1 select 


18 


RDDATA 


Read data input 


19 


WRDATA 


Write data output 



11.11 Serial I/O 



The RS-232 signals are defined in 
the Glossary. 



Apple lie has built into it two 6551 Asynchronous 
Communication Interface Adapters (ACIA) and supporting input 
and output buffers for full-duplex serial communication. 
Figure 11-27 is a block diagram of the Apple lie serial ports, 
ACIA outputs are buffered by a 1448 quad line driver. Similarly, 
ACIA inputs are buffered by a 1489 quad line receiver. 

Figure 11-28 is a detail block diagram of the 6551 ACIA. The 
registers are described in sections 11.11.1 through 11,11.4. 
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Figure 11-27, Serial Port Circuits 
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Figure tf-28. 6551 ACtA Block Diagram. Copyright 1978, Synertek Inc. 
Used by permission of Synertek inc., 3001 Stender, Santa Clara, CA 95052. 
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Figure 11-29, The 6551 Pinouts 
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The 6551 pin assignments are shown in Figure 11-29 and 
described in Table 11-19. Note that the two 6551s are not used 
in exactly the same way— each one supports a different set of 
interrupts. 

Port 1 reads external interrupts (EXTINT") on its Data Set 
Ready (DSR) pin. This input is tied to +5 V through a 3.3 Kohm 
pullup resistor. 

Table 11-19. The 6551 Signal Descriptions 



Pin Number 


Name 


Description 


1 


GND 


Power and signal common ground 


2 


A4 


Address line 4 to select serial 
port 1 




AS 


Address line 5 to select serial 
port 2 


3 


SER* 


Serial device select from GLU 


■- 


RESET' 


Resets both serial ports 



5 
6 

7 

B 

9 

10 

11 

12 

13,14 

15 

16 
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26 

27 
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A0,A1 
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IRQ- 
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R/W 



No connection 
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Request to Send output 

Clear to Send input 

Transmit Data output 

No connection 

Receive Data input 

Address lines and 1 

+ 5 volt supply 

Data Set Ready input 

External interrupt (port 1 ACIA) 

Keyboard strobe input (port 2 
ACIA; Appendix E) 

Eight-bit data bus 

Interrupt Request input 

Phase clock pulse 

Read/write select input 
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The back panel connectors for both serial ports are 5-pin DIN 
jacks. The pin assignments are shown in Figure 11-30 and 
described in Table 11-20. 

Figure 1 1-30. Serial Port Connectors 










Pin Port 1 Port 2 








1 DTR1B DTR2B 




2 TD1B TD2B 

3 GND GND 

4 RD1B RD2B 
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5 DSR1B DSR2B 








Table 11-20. Serial Port Connector Signals 




Pin Number Name 






Description 


1 DTR1B 






Data Terminal Ready output 


DTR2B 








2 TD1B 






Transmit Data output 


TD2B 








3 GND 






Power and signal common 


4 RD1B 






Read Data input 


RD2B 








5 DSR1B 






Data Set Ready input 


DSR2B 
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11.11.1 ACIA Control Register 

Figure 11-31 shows the bit assignments for the ACiA Control J^ 

Register, which the hardware locates at address $C09B for 

serial port 1, and $COAB for serial port 2. This register 

determines the number of data and stop bits the ACIA will 

transmit and receive, and the clock source and baud rate to use 

for data transfer. 

The receiver clock source is derived from the Apple lies TMG 
chip; the resulting baud rates are equal to or up to 2% lower 
than the nominal rate. {The EIA standard allows plus or 
minus 2% variation.) If an Apple lie serial port is used with a 
modem that is 2% above the nominal rate, framing errors can 
occur, especially at 1200 baud and above, when using eight 
data bits. It may be necessary to select a lower baud rate for 
8-bit binary data transfers. ^ 

Urn 
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Figure H-31. ACIA Control Register. Copyright J 978, Synertek Inc. 

Used by permission of Synertek inc., 300 1 Stender. Santa Clara , CA 95052. 
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1 1.11.2 ACIA Command Register 

Figure 11-32 shows the bit assignments for the ACIA Command 
register, which the hardware locates at address SC09A for 
serial port 1 . and at SCGAA for serial port 2. This register 
controls specific transmit and receive functions: parity checking, 
echoing input to output, allowing transmit and receive interrupts, 
and setting levels for Data Terminal Ready and Request to 
Send. 



Figure 11-32. ACIA Command Register Copyright 1978, Synertek Inc. 
Used by permission of Synertek Inc., 3001 Slender. Santa Clara, CA 95052. 
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11.11*3 AC/A Status Register 

Figure 11-33 shows the bit assignments for the ACIA Status 
Register, which is hard-wired to address SC099 for serial 
port 1, and $C0A9 for serial port 2. This register reports the 
condition of the transmit/receive register, errors detected 
during data transfer, and the level of the Data Carrier Detect, 
Data Set Ready and interrupt request lines. 

Figure 11 33. ACIA Status Register Copyright 1978, Synertek inc. 

Used by permission of Synertek Inc., 3001 Slender, Santa Clara, CA 95052. 
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ft. 11.4 AC/A Transmit/Receive Register 

Each ACIA uses the same address— $C098 for serial port 1 , 
$C0A8 for serial port 2 — as temporary data storage for both 
transmission and reception of data. 



11. 12 Mouse Input 



The mouse is a hand-held X-Y pointing device that can be rolled 
along a flat surface. It has an attached pushbutton. This section 
describes how mouse movement and direction can be detected 
and interpreted. 

A mouse has a ball inside its housing that protrudes a small 
distance so that its turning corresponds to mouse movements 
across a tabletop. Two wheels inside the housing, set at 
90-degree angles to each other, follow movements of the ball; 
this causes two disks to rotate. The disks have rectangular 
holes arranged near their edges, making them resemble circular 
slide mounts used with stereoscopic slide viewers. 

The light from a tiny infrared emitter reaches a photoreceptor 
whenever one of the holes on the disk lies between them. An 
internal circuit in the mouse causes the resulting voltage to 
swing quickly to a 1 or a value as soon as a certain threshold 
is crossed. The result is something approximating a square 
wave (Figure 1 1 -34) that varies directly with the speed of mouse 
movement One of these indicates the X component (XO) of 
mouse movement; the other, the Y component (YO). 

Under program control, either the rising edge or the falling edge 
of each square wave can cause an interrupt, which the firmware 
handles by updating a counter. However, the program needs to 
know whether to add or to subtract 1 from a counter; that is, it 
needs to know the direction of X or Y movement 



J 

i 



When the register is used for transmitting data, bit is the 
leading bit to be transmitted; unused data bits are the 
high-order bits, which are ignored. 

When the register is used for receiving data, bit is the first bit 
received; unused data bits are the high-order bits, which are set 
to 0. Parity bits never appear in the receive data register; they 
are stripped off after being used for external parity checking. 



262 I Chapter 1 1 : Hardware Implementation 



J 

3 

A 

3 

i 

'J 



Figure 11-34. Sample Mouse Waveform 
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There is a second infrared emitter/photoreceptor pair almost 
180 degrees opposite the first pair for each disk. These pairs 
are positioned in such a way that the square waves they 
generate are approximately a quarter-wave offset from their 
respective movement waves (Figure 11-35). These waveforms 
are called X1 (X direction) and Y1 (Y direction). 

When a rising edge of X0 causes an interrupt, a mouse-driver 
program can immediately check whether X1 is (indicating a 
movement to the right) or 1 (indicating a movement to the left). 
Similarly, the mouse driver can read Y1 immediately after a 
Y0 interrupt to determine whether the mouse moved up or 
down one count along the Y axis. 

Figure 11-35. Mouse Movement and Direction Waveforms 
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Figure 11-36 shows the pin assignments for the mouse DB-9 
connector on the back panel. Table 11-21 gives the signal 
names and descriptions. 

Figure 11-36. Mouse Connector 
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Pin 


Signal 




1 

2 
3 

A 

5 

G 
7 
B 
9 


MOUSEID* 

4-5V 

GND 

XDIR 

XMOVE 

(N.C) 

MSW' 

YDIR 

YMOVE 




Table 


11-21. Mouse Connector 




DB-9 
Pin Nu 


Signal 
mber Name 


Description 


l 


MOUSEID* 


Mouse identifier; when active, 
disables NE556 hand controller 
timer. 



+ 5V 

GND 

X1 

XO 

MSW 4 

Y1 

YO 



Total current drain from this pin 
must not exceed 100 mA. 

System ground 

Mouse X -direction indicator 

Mouse X-movement interrupt 

Mouse button 

Mouse button 

Mouse Y-direction indicator 

Mouse Y movement interrupt 
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Figure 11-37 shows the mouse and hand control circuitry with 
the mouse circuits highlighted. Figure 11-38 illustrates the 
values of the mouse-button circuit when the button is pressed 
or not pressed. Pressing the button disables the NE556 by 
pulling the reset comparator threshold value up so that it cannot 
reset the flip flop. As a result the mouse-button input value 
remains at a TTL level 



Figure 1 1-37. Mouse Circuits 
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Figure 1 1-38> Mouse Button Signals 

Input Current 25 1— 
(mA) 



1 
Undefined (5V,2t4mA) 



-5 - 



(4.3V,6,2mA) 




3 



Input Voltage 

(Volts) 







(5V, 14,3mA) 



-5 - 



U- 



4 4.5 5 

Input Voltage «— ^ 



(2.9V,0mA) 



r (0V - 16,3mA) 
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1 1. 13 Hand Controller Input 
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Several input signals that are individually controlled via soft 
switches are collectively referred to as the hand controller 
(game) signals. These signals arrive in the Apple lie via the 
same DB-9 connector as the one used for the mouse 
(section 11.12), but the Apple lie interprets these signals 
differently. 

The DB-9 connector pin assignments and signal descriptions, 
as used for hand control input, appear in Figure 11-39 and 
Table 11-22, 

Even though they are normally used for hand controls, these 
signals can be used for other simple I/O applications. There are 
two one-bit switch inputs, labeled SWO and SW1 , and two 
analog inputs, called paddles and labeled PDLO and PDL1. 
Figure 11-40 shows how to connect the one-bit switch inputs 
for compatibility with all other Apple II series computers. 

The switch inputs are multiplexed by a 74LS251 8-to-1 
multiplexer enabled by the C06X* signal from the MMU. 
Depending on the low-order address, the appropriate game 
input is connected to bit 7 of the data bus. Figure 11-41 shows 
the mouse and hand control circuitry with the hand control 
circuits highlighted. Figure 11-42 illustrates the values of the 
hand-control switch inputs when the switch is open or closed. 

Figure 11-39. Hand Controller Connector 
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Pin Signal 



1 
2 
3 
4 

5 
6 

7 



GAMESW1 

-5V 

GND 

Not used for 

hand controls 
PDLO 
(N.&) 
GAMESWO 
POL1 
Not used for 

hand controls 



P5 
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Table 11-22. Hand Control Connector Signals 



Connector 


Signal 


Pin Number 


Name 


1 


GAMESW1 


2 


+ 5V 



GND 



5,8 PDLO and POL1 



6 N.C 

7 GAMESWO 

Figure 11-40. How to Connect Switch inputs 
+ 5 



Description 

Switch input 1 (sometimes called 
paddle button 1) 

+5 V power supply, Total current 
drain from this pin must not 
exceed 100 mA, 

System ground 

Not used for hand controls 

Hand control inputs. Each of these 
must be connected to a 150 Kohm 
variable resistor connected 
to +5V. 

Not connected 

Switch Input {sometimes called 
paddle button 0) 



fl 



470 v. 




Switch: OK 



Vce =i0.3V 

ee- 



5* 30mA 
Saturated: OK 



O 





Schottky: NO 



Ground Level: NO 



Emitter Follower: NO 
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Figure 11-41. Hand Control Circuits 
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Figure 11-42. Hand Control Signals 

Input Current 25 j— 

(mA) 



Undefined (5V.21.4fn A) 




<4,3V,6.2mA) 



4 4.5 5 

nput Voltage 
(Volts) 
{3.2V.0mA) 



r(0V, -29.2mA) 



15i- 



(SV,14.3mA) 




IP 



4.5 5 _^ 

nput Voltage 

(Volts) ^ 



(2.9V,0mA) 
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The hand-control inputs are connected to the timing inputs of 
an NE556 dual analog timer. Addressing $C07X sends a signal 
from MMU pin 22 that resets both timers and causes their 
outputs to go to 1 (high). A variable resistance of up to 
150 Kohms connected between one of these inputs and the 
+ 5 V supply controls the charging time of one of the two 
0.022 microfarad capacitors. 

When the voltage on the capacitor passes a certain threshold, 
the output of the NE556 changes back to (low). Programs can 
determine the setting of a variable resistor by resetting the 
timers and then counting time until the selected timer input 
changes from high to low. The resulting count is proportional to 
the resistance. 

Warning 

The only way to ensure correct paddle values is to make sure 
the output of the paddle you intend to read is low before you 
trigger the timer Triggering the timer starts the charging cycle 
for the capacitor in each paddle circuit; the cycle for one may 
not be completed by the time you have read the other. If you 
retrigger or read the other paddle too soon (that is, in less than 
3 ms), you will get a false value for it 
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The following pages contain schematic diagrams for the 
Apple lie. 
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References to entries in Volume 2 are in square brackets 



Cast of Characters 

* (asterisk) 1 79 

\ (backslash) 59 

_ (blinking underscore cursor) 

> (greater than sign) 59 

? (question mark) 58, 59 

] (right bracket) 59 

A 

A register 17 

accumulator 17 

ACIA 134, 148 r 253-262, [63] 

block diagram 255 

interrupts [60] 
address bus 12, 213 
AKD 218-219 

ALTCHAR 104-105, 218, [73] 
alternate character set 68, [73] 
ALTZP 25, 26, 216, [46] 
analog inputs 1 76, [68] 
annunciator outputs [76] 
ANSI [84] 
any-key-down 79, 229 

flag [66] 
Apple Extended 80-CoJumn 

Text Card [67, 74] 
Apple Language Card [64] 



154 



Apple (I series differences [60-78] 
Apple lie 

block diagram 210 

care of 205-206 

differences from Apple lie [61-78] 

expansion 2 
Apple lie ROMs [72] 
Applesoft & commands 52 
Applesoft BASIC 59, (16-18, 40] 

BASIC interpreter 24 
Applesoft interpreter 21 r 224-225 
arithmetic, hexadecimal 193 
ASCII [71, 83, 86-87] 

character set 79, [97, 114-122] 
assemblers 199 

assembly language, and mouse 171 
asterisk O 179 
automatic line feed 131, 145 
automatic repeat 3 
Autostart ROM [69] 
auxiliary memory screen holes 
135-136. 149-150 
See also screen holes 
auxiliary RAM 20 
AUXMOVE See MOVEAUX 
AY-3600-type keyboard decoder 229 
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B 

B command 131, 144 
back panel 8, 9 
backslash (\) 59, 62 
backspace 62 
bank 25 

bank-switched memory 22, [64, 69] 
BANK2 216 

BASIC 130, 163, 175-177, 179, 180, 
192, [114] 
and assembly language support 171 
and hand controls 173 
and mouse 163, 172 
BASICS disk [39,69] 
baud rate 137, 258 
BCLK 256 
BELL 84 
BELLI 84 
BIT instruction [3] 
bits [103] 

blanking intervals 233 
blinking underscore cursor (_) 154 
block diagrams 
ACIA 255 
Apple lie 210 
BREAK 132, 137, 145 
break instructions [48] 
BREAK signal [75] 
BRK 75, 189, [43] 
buffer 59 

serial I/O [75] 
built-in diagnostics [62] 
built-in disk drive 8 
built-in self-tests [65] 
button interrupt mode 164, 167 
bypassing firmware [58-60] 
byte(s) [103, 104] 
power- up 51 

C 

C06X 267 
C07X 217 
C3COUT1 55, 64 



C3KEYIN 55 
CALL statement 179 
Canadian keyboard [91) 
cancel line 62 
f caps-lock) 4, 79, [84] 
card(s) [74,75] 
care of computer 205-206 
carriage return 139, 152 
carrier 137 

CAS (column-address strobe) 228 
cassette input and output [67-68, 77] 
certifications [99] 
CH (cursor horizontal) 63 
changing memory contents 184 
changing registers 190 
character(s) 
flashing 68 
generator 241 
inverse 68 
normal 68 
sets [71,73] 
chips, custom [78] 
clamping boundaries 171 
CLAMPMOUSE 168 
CLEARMOUSE 168 
CLEOLZ 116 
clock 211 
master 213 
system 213 
CLREOL 116 
CLREOP 116 
CLRSCR 117 
CLRTOP 117 

code conversions [114-122] 
cold-start procedure 49, 50 
colors 
high-resolution 243 
low-resolution 242 r [63] 
command character 146, [75] 
command register 134, 148, 260 
Communication Card [74] 
communication port 141 
comparing data in memory 188-189 
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connector(s) 

back panel 8-9 

game [76] 

power 207 

serial port 257 
CONTINU E BASIC command 
(control] 4, 79. 229 

transferring 42-43 
control characters 64 
control register 134, 148. 258-259 
CONTROL-A, as command character 

143 
( control H P [531 
(control .H IT) 62 
CONTROL-I, as command character 

130, 132 
CONTROL-K, as command character 

193 
( control H T) 56, 126, 142 

as command character 193 

[CONTROL H p 155 



( CONTROL H 13 [53] 

(CONTROL H P 156, 159 

( CONTROL H P 62 

( CONTROL H P 197 

commands 52 

CONTROL RESET 50 

conversion, number [106] 

COUT 55. 117, 191 

COUT1 55, 68, 117 

CP/M [40] 

CPU See65C02 

CR See carriage return 

CREF 220. 221, 251 

CROUT 117 

CROUT1 117 

CSW 56, 70, 104 

cursor 58, 130, 143, 193 
blinking underscore (_) 154 
flashing checkerboard 55 
flashing question mark 130, 143 
inverse solid 55 



custom chips [78] 

custom integrated circuits 215-223 

CV 63 



D command 131, 144 

data, transferring 41-42 

data bits 137 

data bus 213 

Data Carrier Detect [60] 

data format 137 t 138, 144, 151 

data inputs 21 

Data Set Ready See DSR 

Data Terminal Ready See DTR 

DCB 261 

DCD [60] 

decimal, negative [107] 

device signature 72 

DEVNO [21] 

DHIRES 49, 104, 106, 107, 166 

diagnostics, built-in [62, 65] 

differences among Apple lis [61-78] 

disable MouseText 65 

DISK 221, 222 

disk 

controller cards [74] 

controller unit See tWM 

input and output 124-126 

I/O firmware entry points 20 
disk drive 8 

connector 252 

port [50] 

speed 13 
disk-use light 6, [71] 
display 

address mapping 235-238 

inverse 191 

memory addressing 234 

memory switches 43-47 

modes 104-108, 239-247 

normal 191 

page maps 108-114 

pages 102-103 
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DISVBL 166 

DISXY 166 

DMA transfers [70] 

DOS 126, 130, 143, 179, 180, [39, 69] 

interrupts [42] 

zero page use [16-18] 
double-high-resolution 245 

graphics [74] 

colors 100-101 
drive, external, startup 126 
drive motor 49 
DSR 256, 261 , [60] 
DSR1B 257 
DSR2B 257 
DTR 260 
DTR1B 257 
DTR2B 257 
dumb terminal 159 
Dvorak keyboard 6, [88] 
dynamic-RAM refreshment and timing 
226-229 



echo 131, 145, 155, 260 

EIA standard 258 

80 columns 65, 93 

80/40 column switch 5 

80COL 104,105,107,108,218.219, 

220 
80STORE 39, 44, 45, 104, 105, 107. 

108, 216, 238, 241 
electrical power 206 
EN80 217 

enable MouseText 65 
ENBVBL 166 
ENBXY 166 
ENCLCRAM 216 
English keyboard [90] 
enhanced video firmware 20, 224 
enter terminal mode 1 45 
entry points, firmware [31-36] 
environmental specifications 205-206 
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CUD® 61 
fEscl (p 61 
escape codes 60 
escape sequences 4 
even-parity [114] 
EXAMINE command 190 
examining memory contents 181 
examining registers 190 
expansion ROM space 73 
Extended 80-Column Text Card [64] 
external drive startup 126 
external interrupts [55] 
external power connector 207 
EXTINT 256, [55 t 60] 



FCC [99] 
firmware 12 

entry points [30-36] 

listings [126-215] 

locations [30-36] 

protocol 71, 134. 148 

video routines 115-123 
flag inputs 21 
FLASH 256 
flashing characters 68 
flashing checkerboard cursor 55 
flashing power light 6 
forced cold start 50 
14M 215, 220, 221 
FORTRAN [41] 
40 columns, switching to 80 5 
40-column 65, 93 
48K memory 34, 35, 39 
framing errors 258 
French keyboard [91-92] 
full duplex 156-158 
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GAME I/O connector 

game input 267 

game paddles See hand controls 

GAMESWO 268 

GAMESW1 268 

General Logic Unit (GLU) 13 

German keyboard [93] 

GETLN 58-62. 180 

GETLN1 59, 82 

GETLNZ 82 

GLU 221 

GND 257 

GO command 189, 190, 192, 198 

graphic bits [109] 

graphics mode 96-102 

greater than sign (>) 59 

H 

half duplex 155 

hand control 8, 173-178 

circuits 259 

connector 174 

input [76] 

signals 270 
hand controller 267 
handle 9, 206 
hardware 

accesses 21 

addresses [66] 

locations 181, [15] 

page locations 164 
headphones 232 
heat 206 
hexadecimal [106] 

arithmetic 193 



high-resolution 97 

colors 243 

display 243 

double 245 

graphics colors 98-99 

Page 1 37 

Page 2 38 
HIRES 44, 45, 104, 105, 107, 216, 

218, [67] 
HLINE 117 
HOME 118 
HOMEMOUSE 168 
HRP1 37 
HRP1X 37, 45 
HRP2 45 
HRP2X 38 
humidity 205 

/ 

I command 131, 145, 158 

I/O firmware, video routines 1 20-1 23 

I/O links 55 

icons 68 

identification bytes 71 

IEC [99] 

IN#2 143, 154 

IN#n 56, 70 

index registers 17 

INH 217 

INJTMOUSE 169 

input and output, disk 124-126 

input buffer (page $02) 36 

Input/Output Unit (IOU) 13, 215, 

218-219, [78] 
instruction cycle times [63] 
Integer BASIC 59,(16-18,41,69] 
Integrated Woz Machine (I WM) 13 
internal converter 208 
internal voltage converter 206 
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interrupt(s) 24, 75, 260. [40-60, 70J 


J 


ACIA |49] 
Apple 11 and [42J 


jack 7 

JMP $C600 126 


Apple II Plus and [42] 


JMP indirect instruction [3] 


Apple lie and 143] 
disk drive port [49] 


joysticks See hand controls 


DOS and [42] 




keyboard [52-53] 


K 


Monitor and [42] 


K(1024) 17 


mouse [49] 


K command 131, 145 


Pascal and [42] 


KBD 217 


65C02 and [43] 


keyboard 229-231 


6551 [49] 


buffer [52-53] 


vertical blanking [49] 


character decoder 225 


interrupt handlers) 


circuit diagram 230 


mouse 163 


data [66] 


users [57] 


input buffer 37 


interrupt requests 52 


interrupts [52, 53] 


interrupt vector [43-44] 


layout [71] 


interrupt-handling sequence [45] 


ANSI [90] 


inverse 65 


British See English 


characters 68 


Canadian [91-92] 


display 191 


Dvorak [881 


solid cursor 55 


English [90] 


INVERSE command 191 


French [91-92] 


invoking the monitor 179 


German [93] 


IOREST [36] 


ISO [90] 


IORTS [36] 


Italian [94-95] 


IOSAVE [36] 


Sholes [85] 


IOU (Input/Output Unit) 13, 215, 


Western Spanish [96] 


218-219, [78] 


signals 231 


IOUDIS 49, 104, 106, 166, [67, 681 


strobe 79, 229, [50, 66] 


IOUSELIO 219 


switch 5 


IRQ 75, 156, 219, [43] 


standard 5 


handling routine [34] 


KEYIN 55, 57, 58 


vector [36| 


KSTRB 77, 219, 256 


ISO [84] 


KSW 56, 57, 70, 104 


layout [891 




Italian keyboard [94] 


L 


IWM (Integrated Woz Machine) 13, 




222 


L command 131, 145 




LANGSW 256 




LDPS 220, 241, 251 
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line feed 145, 152 

automatic 131 
line length 136, 150 
line voltage 205 
line width 139, 144 
LIST command 199 
local 1 54 
low-resoiution 

colors 242 

display 242 

graphics 96 

M 

machine identification [63) 

main memory screen holes 135-136. 

149; 150 
main RAM 20 
MARK (1) 132 
MARK parity 138 T [114] 
master clock 213 
maximum current drain 252 
memory 

addressing 223-229 

bank-switched 22 

bus organization 224 

comparing data in 188-189 

display switches 43-47 

dump 182-184 

examining contents 181 

48K 34 " 

map 18, [15-28] 

moving data in 186-188 

organization [64] 

state [48] 

switches, display 43-47 
Memory Management Unit See MMU 
microprocessor, 65C02 12, 15 
mini-phone jack 7 
MIXED 105 t 107, 218, [67] 
mixed-modes displays 102 
MMU 13, 215-217, 267, 271, [78] 
mnemonic 199 
modem 8 t 151 
modes, display 239-247 



monitor 8, 24, 59, 179-203, 224 

entry point [36] 

interrupts and [42] 

output 248 

register commands 189-190 

ROM [69] 

video routines 115 

zero page use [15) 
mouse 8, 160-174, [49-50] 

BASIC and 163, 172 

Pascal and 171 

button 171 
interrupt mode 1 64 
signals 266 

clamping boundaries 171 

connector 264 

direction [59] 

firmware 167 

firmware entry points 20 

hardware locations 164-167 

input 262, [76] 

interrupt handler 165 

interrupts [58] 

movement interrupt mode 163 

operating modes 163 

port 161-174 

transparent mode 163 

waveform 263 

X direction 167 

Y direction 167 
MOUSEID 264 

MouseText 65, 68-69 f 90-91, [73, 114] 
MOUX1 167 
MOUY1 167 

MOVE command 186-188, 195, [36] 
MOVEAUX 41-42 
movement/button interrupt mode 164, 

167 
movement interrupt mode 1 63. 1 67 
moving data in memory 186-188 
MSLOT [211 
MSW 264 
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N 

N command 131, 145, 156 

n CONTROL-K 56 

NE556 265, 271 1 [77] 

negative decimal [1 07] 

NEWIRQ [34] 

nibble [104] 

NMI vector [36, 43] 

non-maskable interrupts 52 

NORMAL command 191 

normal characters 65, 68 

normal display 191 

NTSC 87, 233. 242, 248, 251 

#6 130 

#7 143 

#8 143 

o 

odd-parity [114] 

old monitor ROM [62] 

1 CONTROL-P 130 

1VSOUND 251 

QD 4,82 

operand 199 

operating systems [39-40] 

operating temperature 205 

output and input, disk 124-126 

output jack 232 



P command 132, 145 
P register 17 
paddle(s) 267 

button 268 

button 1 268 

inputs [68, 76] 

timing circuit [77] 
page 18 

page $02 (input buffer) 36 
page $03 36 
page $04 36 
page $08 37 



page 18 

page zero 24 

page 1 18 

PAGE2 44-45,105,107-108,216, 

238, 241 , [46-48, 67] 
page three [19] 
page 8, auxiliary RAM [52] 
PAL 233 
parity 145 

bit(s) 138, 262 

checking 260 
Pascal 67, 126. 130, 134, 170, [114] 

ID byte 134, 148 

interrupts and [42] 

language [41] 

operating system [40] 
PC (program counter) 16 
PCAS 220 
PDL0 176 
PDL0/XMOVE 219 
PDL1 176 
PEEK [40] 

peripheral identification numbers [112] 
peripheral-card memory space [65-66] 
peripheral-card ROM space [65] 
phone jack 7 
PIN numbers [112] 
PINIT 72, 121. 134, 148 
PLOT 118 
plotter 8 
POKE [40] 
ports 70, [70] 
POSMOUSE 168 
power 8 

connector 207 

consumption 207, 208 

light 6, [711 

requirements 206 

supply [100] 
power-on light [71] 
power-up byte 51 
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PR#1 130 
PR#2 143, 154 
PR#6 126 
PR#n 56, 70 
PRAS 217, 219, 220, 251 
PRBL2 118 
PRBYTE 118 

PREAD 72 t 121, 134, 148. 177 
PRERR 118 
PRHEX 118 

primary character set 68, [73] 
printer 8 
PRINTER: 130 
processor status register 17 
ProDOS 126, 130, 143, 180, [39, 63] 
program counter (PC) 16, 201 
prompt 58 r 154 
characters 59 
PRTAX 118 

PSTATUS 72, 123, 134, 148 
PTRIG 166 

published entry points f32-36] 
pull from stack 1 7 
push onto stack 17 
PWRITE 72, 121, 134, 148 



Q command 145 
Q3 215, 217, 219 
question mark (?) 58, 59 
quit terminal mode 145 



R command 132 
R/W 217, 219,221,257 
RA0-RA7 217 
RAM 17 

addressing 226-229 

locations [15J 
RAMRD 38, 39. 43, 44, 216. [46] 
RAMWRT 38, 39, 43, 44. 216. [46] 



random number 58 
random-access memory (RAM) 17 
RAS (row-address strobe) 228 
RD1B 257 
RD63 167 
RD80COL 105 
RD80STORE 105 
RDALTCHAR 105 
RDALT2P 26 
RDBNK2 26 
RDCHAR 82 
RDCRAM [46] 
RDDHIRES 106 
RDHIRES 45 r 105 
RDIOUDIS 106, 166 
RDKEY 55, 57 
RDLCRAM 26 
RDMIXED 105 
RDPAGE2 105 
RDRAMRD 39 
RDRAMWRT 39 
RDTEXT 105 
RDTNO 167 
RDVBLMSK 166 
RDXYMSK 166 
RDYOEDGE 166 
read-only memory (ROM) 17 
READMOUSE 163, 168, [51-52] 
receive register 262 
registers 15, 213 
examining 190 
relative humidity 205 
REMIN 143 
remote 154, 159 
remote device 145 
REMOUT 143 
(rept) key [71] 
Request to Send See RTS 
CreseT) key 4, 79. 82, 221. 113, 256, 

[71] 
reset port 1 132 
reset port 2 145 
reset routine 48 
reset vector 49-51, [36] 

(RETURN) [84] 
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retype 62 

RF modulator 233 

RGB monitor 245 

rollover 3 

ROM 17 

ROM addressing 224-225 

ROMEN2 217 

RS-232 129 

RSTVBL 166 

RSTXINT 166, 216 

RSTXY 166 

RSTYINT 166, 216 

RTS instruction 260, [36] 



S command 132 
S register 17 

safety instructions 207, [99] 
schematic diagrams 271-276 
scratch-pad RAM [65] 
screen holes 36, 73, 74, 133, 134, 
136, 149, 171-173, [20-22, 47] 
SCRN 119 
scroll 65 
SEGA 218 
SEGB 218, 220,251 
self-tests See diagnostics, built-in 
SER 221 , 256 
serial buffering [55] 
serial data transfer [57] 
serial firmware [50] 
serial I/O buffers [75] 
serial I/O port 128-159 
serial input buffer 37 
Serial Interface Card [74] 
serial interrupts [55, 56] 
serial port circuits 254 
serial port 1 20, 129-139 
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serial port 2 20, 141-159 


J 


command character 143, 146 


command character hardware 


t-j 


locations 130, 132, 134 




firmware protocol 147 


d 


hardware locations 148 


U-J 

c 1 


initial characteristics 130,147 


SEROUT 251 


SERVEMOUSE 163, 168, [51] 


SETCOL 119 




SETMOUSE 167-168. [50-51] 


H 


SETPWRC 51 


J 

L-J 


7M 220. 223 


(shift) key 79, 229, [84] 


shift-key mod [68] 


Sholes keyboard 5 




signature byte 134, 148, 170 


■ 


simplified keyboard (Dvorak) [88] 


U— 


® 126 




65C02 12, 15. 163] 


a 


address bus 213 


addressing modes [10] 


block diagram 211 


clock 211 


cycle time [1 , 2] 




data bus 213 


zz 


data sheet [5-13] 


3 


differences from 6502 211, 


[1-3, 6-7] 
execution time [1-2] 


instruction set [12-13] 




opcodes [12] 


ul 


registers 213 


fcH 


signal descriptions [11] 


timing diagram [8] 


timing signals 214-215 


6502 verus 65C02 21 1 


6551 Asynchronous Communication 


Interface Adapters See ACIA 




slot 7 drive 1 [74] 




SLOTC3ROM [66| 


p 


SLOTCXROM [66] 




e= 




fi= 



slots 70 

versus ports [70] 
soft switches 22,215,218,221 
C«3 82 

SPACE (0) 132 
SPACE parity 138, [114] 
speaker 83-84, [67] 

external 7 

output jack 232 

volume control 232 
SPKR 219 
stack 24, [42 t 46] 
stack pointer 17 
standard I/O links 55 
standard keyboard 5 
start bit 137 

status register 134, 148, 261 
stop bits 137 
stop-list 65 
STORE command 194 
strobe 79 

inputs 21 
SUD See System Utilities Disk 
Super Serial Cards [74] 
SWO 175 
SW1 175 

switch inputs 175, [76] 
switches, soft 22, 215 
SYNC 219, 233, 251 
system clock 213 
system monitor 179-203 
System Utilities Disk 129, 131, 136, 
141, 145, 150, 175, 112] 



T command 145, 154-156. 159 
QaD [84] 
TD1B 257 
telephone jack 7 
temperature 205, 208 



terminal mode 145, [531 

TEXT 105,107,218,220,221,251, 

[67] 
text 

and low-resolution graphics Page 1 
36 

and low-resolution Page 1X 36 

and screen low-resolution Page 2 
37 

displays 241 

modes 90-95 

window 63, 66 
TLP1 36 
TLP1X 36, 45 
TLP2X 37 
toggle switches 22 
transferring control 42-43 
transferring data 41-42 
transmit/receive data register 

148 
transmit register 262 
transparent mode 163,167,171 
triggering paddle timers [68] 



134, 



U 



5 



USA standard keyboard 
USER command 197 
users interrupt handler [57] 
utility strobe [67] 

V 

validity check 49 
VBL [67, 73, 76] 
VBLINT 163, 164, 218, [67, 731 
VDE [99| 
vectors 55 
ventilation 206 

VERIFY command 188, 196, |36] 
vertical blanking 163, [49, 50, 73] 
interrupts [68] 
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VI D 248 
VID7M 215, 220 
video 

counters 233-234 

display 225 

display circuits 240 

display modes 239-247 

expansion 8 

expansion connector 249-252 

expansion output 249 

output signals 248 

routines 
firmare 115-123 
I/O firmware 120-123 
monitor 115-119 
VLINE 119 
voltage 205 

converter 1 
volume control 7, 232 

W 

WAIT [36] 

warm-start procedure 50 

Western Spanish keyboard [96) 

WNDW 219, 233. 251 

word [106] 

Woz Integrated Machine 13, 222 



X register 17 

X0 215, 218,262, 264 

XI 215, 263, 264 
XFER 41,42 

XI NT 164, [66, 67] 
XOEDGE 166 



Y register 17 
Y0 218, 262,264 
Y1 263,264 
YINT 164, [66, 67] 
YMOVE 219 
YOEDGE 166 



Z command 132, 139 
zap 132, 139, 145 
zero page 24, 184 
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